agl 1.0.17 → 21.0.2

package/ts_interfaces/requests.ts

@@ -0,0 +1,1186 @@
+import * as plugins from './plugins.js';
+import type {
+  IControllerEvent,
+  IControllerMessageBundle,
+  IControllerMessagePage,
+  TControllerModelChoice,
+  TControllerModelOption,
+  IControllerPathSuggestion,
+  IControllerProject,
+  TControllerResource,
+  TControllerResourceKind,
+  IControllerBrowserViewState,
+  TControllerBrowserViewEvent,
+  TControllerBrowserViewOperation,
+  IControllerProvider,
+  IControllerProviderAccountRateLimits,
+  IControllerProviderConnection,
+  IControllerProviderLogin,
+  IControllerModelRefreshJob,
+  IControllerRuntimeId,
+  IControllerSession,
+  IControllerSessionDraft,
+  IControllerDraftAttachment,
+  IControllerSessionGroup,
+  IControllerSessionLayout,
+  IControllerTerminal,
+  TControllerTerminalId,
+  IControllerSlashListResult,
+  TControllerSlashExecuteResult,
+  IControllerSessionDetail,
+  IControllerSessionAuxiliary,
+  IControllerSessionScratchpad,
+  IControllerIntelligenceExchange,
+  IControllerSettings,
+  IControllerStatus,
+  IControllerSystemMetrics,
+  TControllerAuthState,
+  TControllerPermissionReply,
+  TControllerSessionHarnessId,
+  TControllerSessionId,
+} from './interfaces.js';
+
+export interface IReq_ControllerStatus extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerStatus
+> {
+  method: 'controller.status';
+  request: Record<string, never>;
+  response: IControllerStatus;
+}
+
+export interface IReq_ControllerUpgradeLaunch extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerUpgradeLaunch
+> {
+  method: 'controller.upgrade.launch';
+  request: {
+    /** One-time 256-bit launch grant created by the local management CLI. */
+    token: string;
+  };
+  response: {
+    accepted: true;
+    workerPid: number;
+    logFilePath: string;
+  };
+}
+
+export interface IReq_ControllerUpgradePrepare extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerUpgradePrepare
+> {
+  method: 'controller.upgrade.prepare';
+  request: {
+    token: string;
+    targetVersion: string;
+    gracePeriodMs: number;
+  };
+  response: {
+    prepared: true;
+    sessionCount: number;
+  };
+}
+
+export interface IReq_ControllerUpgradePrepareBegin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerUpgradePrepareBegin
+> {
+  method: 'controller.upgrade.prepare.begin';
+  request: {
+    token: string;
+    targetVersion: string;
+    gracePeriodMs: number;
+  };
+  response: {
+    accepted: true;
+  };
+}
+
+export interface IReq_ControllerUpgradeFinalize extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerUpgradeFinalize
+> {
+  method: 'controller.upgrade.finalize';
+  request: {
+    token: string;
+    mode: 'continue' | 'compensate' | 'reopen';
+  };
+  response: {
+    finalized: true;
+    continued: number;
+    failed: number;
+  };
+}
+
+export interface IReq_ControllerSystemMetrics extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSystemMetrics
+> {
+  method: 'controller.system.metrics';
+  request: Record<string, never>;
+  response: IControllerSystemMetrics;
+}
+
+export interface IReq_ControllerAuthState extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerAuthState
+> {
+  method: 'controller.auth.state';
+  request: Record<string, never>;
+  response: {
+    state: TControllerAuthState;
+    authenticated: boolean;
+    setupCodeExpired: boolean;
+  };
+}
+
+export interface IReq_ControllerSetupBegin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSetupBegin
+> {
+  method: 'controller.auth.setup.begin';
+  request: {
+    setupCode: string;
+  };
+  response: {
+    ceremonyId: string;
+    options: plugins.PublicKeyCredentialCreationOptionsJSON;
+  };
+}
+
+export interface IReq_ControllerSetupFinish extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSetupFinish
+> {
+  method: 'controller.auth.setup.finish';
+  request: {
+    ceremonyId: string;
+    setupCode: string;
+    response: plugins.RegistrationResponseJSON;
+  };
+  response: {
+    authenticated: true;
+    /** single-use token to re-authenticate this browser after a reconnect */
+    resumeToken: string;
+    /** Unix milliseconds; the resume token stops working after this moment */
+    resumeExpiresAt: number;
+  };
+}
+
+export interface IReq_ControllerAuthenticationBegin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerAuthenticationBegin
+> {
+  method: 'controller.auth.authentication.begin';
+  request: Record<string, never>;
+  response: {
+    ceremonyId: string;
+    options: plugins.PublicKeyCredentialRequestOptionsJSON;
+  };
+}
+
+export interface IReq_ControllerAuthenticationFinish extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerAuthenticationFinish
+> {
+  method: 'controller.auth.authentication.finish';
+  request: {
+    ceremonyId: string;
+    response: plugins.AuthenticationResponseJSON;
+  };
+  response: {
+    authenticated: true;
+    /** single-use token to re-authenticate this browser after a reconnect */
+    resumeToken: string;
+    /** Unix milliseconds; the resume token stops working after this moment */
+    resumeExpiresAt: number;
+  };
+}
+
+export interface IReq_ControllerTempPasswordLogin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTempPasswordLogin
+> {
+  method: 'controller.auth.temppassword.login';
+  request: {
+    password: string;
+  };
+  response: {
+    authenticated: true;
+    /** Unix milliseconds; the credential stops working after this moment. */
+    expiresAt: number;
+    /** single-use token to re-authenticate this browser after a reconnect */
+    resumeToken: string;
+    /** Unix milliseconds; the resume token stops working after this moment */
+    resumeExpiresAt: number;
+  };
+}
+
+/**
+ * Re-authenticates a fresh connection using a resume token minted by a prior
+ * login on this browser. Tokens are single-use: a successful resume rotates
+ * the token, so a stolen historical token cannot be replayed.
+ */
+export interface IReq_ControllerAuthResume extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerAuthResume
+> {
+  method: 'controller.auth.resume';
+  request: {
+    token: string;
+  };
+  response: {
+    authenticated: true;
+    resumeToken: string;
+    resumeExpiresAt: number;
+  };
+}
+
+export interface IReq_ControllerProjectList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProjectList
+> {
+  method: 'controller.project.list';
+  request: Record<string, never>;
+  response: {
+    projects: IControllerProject[];
+  };
+}
+
+export interface IReq_ControllerProjectCreate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProjectCreate
+> {
+  method: 'controller.project.create';
+  request: {
+    /** Existing directory path relative to the projects root; never created. */
+    path: string;
+  };
+  response: {
+    project: IControllerProject;
+  };
+}
+
+export interface IReq_ControllerProjectSuggest extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProjectSuggest
+> {
+  method: 'controller.project.suggest';
+  request: {
+    /** Partial relative path being typed; empty lists the root's directories. */
+    query: string;
+  };
+  response: {
+    suggestions: IControllerPathSuggestion[];
+  };
+}
+
+export interface IReq_ControllerProjectRemove extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProjectRemove
+> {
+  method: 'controller.project.remove';
+  request: {
+    projectId: string;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerProviderList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderList
+> {
+  method: 'controller.provider.list';
+  request: Record<string, never>;
+  response: {
+    providers: IControllerProvider[];
+  };
+}
+
+export interface IReq_ControllerProviderConnectionList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderConnectionList
+> {
+  method: 'controller.provider.connection.list';
+  request: Record<string, never>;
+  response: {
+    connections: IControllerProviderConnection[];
+    /** False when the response is a persisted read-only snapshot. */
+    runtimeAvailable: boolean;
+  };
+}
+
+export interface IReq_ControllerProviderConnectionActivateOpenCode extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderConnectionActivateOpenCode
+> {
+  method: 'controller.provider.connection.activate-opencode';
+  request: {
+    providerConnectionId: string;
+  };
+  response: {
+    activated: true;
+    pausedSessions: number;
+    continuedSessions: number;
+  };
+}
+
+export interface IReq_ControllerProviderLoginBegin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderLoginBegin
+> {
+  method: 'controller.provider.login.begin';
+  request: {
+    providerID: 'openai';
+  };
+  response: {
+    login: IControllerProviderLogin;
+  };
+}
+
+export interface IReq_ControllerProviderLoginGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderLoginGet
+> {
+  method: 'controller.provider.login.get';
+  request: {
+    loginId: IControllerRuntimeId;
+  };
+  response: {
+    login: IControllerProviderLogin;
+  };
+}
+
+export interface IReq_ControllerProviderLoginCancel extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderLoginCancel
+> {
+  method: 'controller.provider.login.cancel';
+  request: {
+    loginId: IControllerRuntimeId;
+  };
+  response: {
+    cancelled: boolean;
+  };
+}
+
+export interface IReq_ControllerProviderConnectionLogout extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderConnectionLogout
+> {
+  method: 'controller.provider.connection.logout';
+  request: {
+    providerConnectionId: string;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerProviderConnectionRateLimitsGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderConnectionRateLimitsGet
+> {
+  method: 'controller.provider.connection.ratelimits.get';
+  request: {
+    providerConnectionId: string;
+  };
+  response: {
+    rateLimits: IControllerProviderAccountRateLimits;
+  };
+}
+
+export interface IReq_ControllerProviderModelRefreshBegin extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderModelRefreshBegin
+> {
+  method: 'controller.provider.model.refresh.begin';
+  request: {
+    providerConnectionId: string;
+  };
+  response: {
+    job: IControllerModelRefreshJob;
+  };
+}
+
+export interface IReq_ControllerProviderModelRefreshGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerProviderModelRefreshGet
+> {
+  method: 'controller.provider.model.refresh.get';
+  request: {
+    jobId: IControllerRuntimeId;
+  };
+  response: {
+    job: IControllerModelRefreshJob;
+  };
+}
+
+export interface IReq_ControllerModelList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerModelList
+> {
+  method: 'controller.model.list';
+  request: Record<string, never>;
+  response: {
+    models: TControllerModelOption[];
+  };
+}
+
+export interface IReq_ControllerSettingsGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSettingsGet
+> {
+  method: 'controller.settings.get';
+  request: Record<string, never>;
+  response: {
+    settings: IControllerSettings;
+    /** Default base directory: relative project paths and initial suggestions resolve here. */
+    projectsRoot: string;
+  };
+}
+
+export interface IReq_ControllerSettingsUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSettingsUpdate
+> {
+  method: 'controller.settings.update';
+  request: {
+    /** Full replacement; an empty list clears all defaults. Absent leaves them unchanged. */
+    defaultModels?: TControllerModelChoice[];
+    /** Absent leaves the auto-accept behavior unchanged. */
+    autoAcceptPermissions?: boolean;
+  };
+  response: {
+    settings: IControllerSettings;
+  };
+}
+
+export interface IReq_ControllerSessionList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionList
+> {
+  method: 'controller.session.list';
+  request: {
+    projectId: string;
+  };
+  response: {
+    sessions: IControllerSession[];
+  };
+}
+
+export interface IReq_ControllerSessionGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionGet
+> {
+  method: 'controller.session.get';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: IControllerSessionDetail;
+}
+
+export interface IReq_ControllerSessionAuxiliaryGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionAuxiliaryGet
+> {
+  method: 'controller.session.auxiliary.get';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: IControllerSessionAuxiliary;
+}
+
+export interface IReq_ControllerSessionModelUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionModelUpdate
+> {
+  method: 'controller.session.model.update';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    model: TControllerModelChoice;
+  };
+  response: {
+    model: TControllerModelChoice;
+  };
+}
+
+export interface IReq_ControllerSessionScratchpadSave extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionScratchpadSave
+> {
+  method: 'controller.session.scratchpad.save';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    text: string;
+    expectedRevision: number;
+  };
+  response: {
+    scratchpad: IControllerSessionScratchpad;
+  };
+}
+
+export interface IReq_ControllerSessionIntelligenceAsk extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionIntelligenceAsk
+> {
+  method: 'controller.session.intelligence.ask';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    question: string;
+  };
+  response: {
+    exchange: IControllerIntelligenceExchange;
+  };
+}
+
+export interface IReq_ControllerSessionMessagesPage extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionMessagesPage
+> {
+  method: 'controller.session.messages.page';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    limit: number;
+    /** Opaque harness cursor returned by the previous page. */
+    before?: string;
+  };
+  response: IControllerMessagePage;
+}
+
+export interface IReq_ControllerSessionMessageGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionMessageGet
+> {
+  method: 'controller.session.message.get';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    messageId: IControllerRuntimeId;
+  };
+  response: IControllerMessageBundle;
+}
+
+export interface IReq_ControllerSessionCreate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionCreate
+> {
+  method: 'controller.session.create';
+  request: {
+    projectId: string;
+    harnessId: TControllerSessionHarnessId;
+    title?: string;
+    /** Initial durable model choice for this session. */
+    model?: TControllerModelChoice;
+  };
+  response: {
+    session: IControllerSession;
+  };
+}
+
+export interface IReq_ControllerSessionDelete extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionDelete
+> {
+  method: 'controller.session.delete';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerSessionDiscardEmpty extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionDiscardEmpty
+> {
+  method: 'controller.session.discard-empty';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: {
+    discarded: boolean;
+    retryable: boolean;
+  };
+}
+
+export interface IReq_ControllerSessionDraftGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionDraftGet
+> {
+  method: 'controller.session.draft.get';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: {
+    draft: IControllerSessionDraft;
+  };
+}
+
+export interface IReq_ControllerSessionDraftUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionDraftUpdate
+> {
+  method: 'controller.session.draft.update';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    expectedRevision: number;
+    text?: string;
+    attachments?: IControllerDraftAttachment[];
+  };
+  response: {
+    draft: IControllerSessionDraft;
+  };
+}
+
+export interface IReq_ControllerSessionSend extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionSend
+> {
+  method: 'controller.session.send';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    /** Exact controller-memory draft snapshot to send and conditionally clear. */
+    draftRevision: number;
+    /** Per-message override; the persisted default applies when absent. */
+    model?: TControllerModelChoice;
+  };
+  response: {
+    accepted: true;
+  };
+}
+
+export interface IReq_ControllerSlashList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSlashList
+> {
+  method: 'controller.slash.list';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: IControllerSlashListResult;
+}
+
+export interface IReq_ControllerSlashExecute extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSlashExecute
+> {
+  method: 'controller.slash.execute';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    draftRevision: number;
+    /** Per-message override; a model pinned by the command itself wins. */
+    model?: TControllerModelChoice;
+  };
+  response: {
+    accepted: true;
+    result: TControllerSlashExecuteResult;
+  };
+}
+
+export interface IReq_ControllerSessionAbort extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionAbort
+> {
+  method: 'controller.session.abort';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerPermissionReply extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerPermissionReply
+> {
+  method: 'controller.permission.reply';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    requestId: IControllerRuntimeId;
+    reply: TControllerPermissionReply;
+    message?: string;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerSessionGroupsGet extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionGroupsGet
+> {
+  method: 'controller.sessiongroups.get';
+  request: {
+    projectId: string;
+  };
+  response: IControllerSessionLayout;
+}
+
+export interface IReq_ControllerSessionGroupsUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionGroupsUpdate
+> {
+  method: 'controller.sessiongroups.update';
+  request: {
+    projectId: string;
+    /** Full replacement: the stored group list becomes exactly this. */
+    groups: IControllerSessionGroup[];
+    /** Omitted by legacy clients; the server then preserves the stored order. */
+    ungroupedSessionIds?: TControllerSessionId[];
+    /** Omitted by legacy clients; current clients use it for optimistic concurrency. */
+    expectedRevision?: number;
+  };
+  response: IControllerSessionLayout;
+}
+
+export interface IReq_ControllerSessionRename extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionRename
+> {
+  method: 'controller.session.rename';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    title: string;
+  };
+  response: {
+    session: IControllerSession;
+  };
+}
+
+export interface IReq_ControllerSessionArchive extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionArchive
+> {
+  method: 'controller.session.archive';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+  };
+  response: {
+    session: IControllerSession;
+  };
+}
+
+export interface IReq_ControllerQuestionReply extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerQuestionReply
+> {
+  method: 'controller.question.reply';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    requestId: IControllerRuntimeId;
+    /** One answer list per question, in question order; null rejects the request. */
+    answers: string[][] | null;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerSessionYolo extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerSessionYolo
+> {
+  method: 'controller.session.yolo';
+  request: {
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    /** True auto-accepts every permission request of this chat until disabled or restart. */
+    enabled: boolean;
+  };
+  response: {
+    enabled: boolean;
+  };
+}
+
+export interface IReq_ControllerTerminalList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalList
+> {
+  method: 'controller.terminal.list';
+  request: {
+    projectId: string;
+  };
+  response: {
+    terminals: IControllerTerminal[];
+  };
+}
+
+export interface IReq_ControllerResourceList extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceList
+> {
+  method: 'controller.resource.list';
+  request: { projectId: string };
+  response: { resources: TControllerResource[] };
+}
+
+export interface IReq_ControllerResourceCreate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceCreate
+> {
+  method: 'controller.resource.create';
+  request: {
+    projectId: string;
+    kind: TControllerResourceKind;
+    title?: string;
+  };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerResourceRename extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceRename
+> {
+  method: 'controller.resource.rename';
+  request: { projectId: string; resourceId: string; title: string };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerResourceAttach extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceAttach
+> {
+  method: 'controller.resource.attach';
+  request: {
+    projectId: string;
+    resourceId: string;
+    sessionId: TControllerSessionId;
+    expectedAttachmentRevision: number;
+  };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerResourceDetach extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceDetach
+> {
+  method: 'controller.resource.detach';
+  request: {
+    projectId: string;
+    resourceId: string;
+    expectedAttachmentRevision: number;
+  };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerResourceRetire extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceRetire
+> {
+  method: 'controller.resource.retire';
+  request: { projectId: string; resourceId: string };
+  response: { retired: true };
+}
+
+export interface IReq_ControllerResourceStart extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceStart
+> {
+  method: 'controller.resource.start';
+  request: { projectId: string; resourceId: string };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerResourceStop extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerResourceStop
+> {
+  method: 'controller.resource.stop';
+  request: { projectId: string; resourceId: string };
+  response: { resource: TControllerResource };
+}
+
+export interface IReq_ControllerBrowserViewOpen extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewOpen
+> {
+  method: 'controller.browser.view.open';
+  request: {
+    projectId: string;
+    resourceId: string;
+    expectedAttachmentRevision: number;
+  };
+  response: {
+    viewId: string;
+    resourceId: string;
+    attachmentRevision: number;
+    state: IControllerBrowserViewState;
+  };
+}
+
+export interface IReq_ControllerBrowserViewActivate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewActivate
+> {
+  method: 'controller.browser.view.activate';
+  request: { viewId: string };
+  response: { activated: true };
+}
+
+export interface IReq_ControllerBrowserViewClose extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewClose
+> {
+  method: 'controller.browser.view.close';
+  request: { viewId: string };
+  response: { closed: true };
+}
+
+export interface IReq_ControllerBrowserViewOperate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewOperate
+> {
+  method: 'controller.browser.view.operate';
+  request: { viewId: string; operation: TControllerBrowserViewOperation };
+  response: { accepted: boolean; state: IControllerBrowserViewState };
+}
+
+/** Server to client push for one exact human browser view. */
+export interface IReq_ControllerBrowserViewEvent extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewEvent
+> {
+  method: 'controller.browser.view.event';
+  request: {
+    viewId: string;
+    resourceId: string;
+    attachmentRevision: number;
+    event: TControllerBrowserViewEvent<'send'>;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_ControllerTerminalCreate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalCreate
+> {
+  method: 'controller.terminal.create';
+  request: {
+    projectId: string;
+    /** Display title; defaults to a shell-derived name. */
+    title?: string;
+  };
+  response: {
+    terminal: IControllerTerminal;
+  };
+}
+
+export interface IReq_ControllerTerminalRename extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalRename
+> {
+  method: 'controller.terminal.rename';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+    title: string;
+  };
+  response: {
+    terminal: IControllerTerminal;
+  };
+}
+
+export interface IReq_ControllerTerminalRemove extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalRemove
+> {
+  method: 'controller.terminal.remove';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerTerminalAttach extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalAttach
+> {
+  method: 'controller.terminal.attach';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerTerminalDetach extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalDetach
+> {
+  method: 'controller.terminal.detach';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerTerminalInput extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalInput
+> {
+  method: 'controller.terminal.input';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+    /** Base64-encoded UTF-8 keystroke bytes. */
+    dataBase64: string;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+export interface IReq_ControllerTerminalResize extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalResize
+> {
+  method: 'controller.terminal.resize';
+  request: {
+    projectId: string;
+    terminalId: TControllerTerminalId;
+    rows: number;
+    cols: number;
+  };
+  response: {
+    success: boolean;
+  };
+}
+
+/** Server→client push: raw PTY output for a terminal the client may be viewing. */
+export interface IReq_ControllerTerminalOutput extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerTerminalOutput
+> {
+  method: 'controller.terminal.output';
+  request: {
+    terminalId: TControllerTerminalId;
+    /** Base64-encoded raw output bytes; empty for pure control frames. */
+    dataBase64: string;
+    /** This chunk starts a fresh replay: reset the screen before writing. */
+    reset?: boolean;
+    /** The PTY ended; no further output follows. */
+    ended?: boolean;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_ControllerEvent extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerEvent
+> {
+  method: 'controller.event';
+  request: IControllerEvent;
+  response: {
+    received: true;
+  };
+}
+
+export type TControllerRequest =
+  | IReq_ControllerStatus
+  | IReq_ControllerUpgradeLaunch
+  | IReq_ControllerUpgradePrepare
+  | IReq_ControllerUpgradePrepareBegin
+  | IReq_ControllerUpgradeFinalize
+  | IReq_ControllerSystemMetrics
+  | IReq_ControllerAuthState
+  | IReq_ControllerSetupBegin
+  | IReq_ControllerSetupFinish
+  | IReq_ControllerAuthenticationBegin
+  | IReq_ControllerAuthenticationFinish
+  | IReq_ControllerTempPasswordLogin
+  | IReq_ControllerAuthResume
+  | IReq_ControllerProjectList
+  | IReq_ControllerProjectCreate
+  | IReq_ControllerProjectRemove
+  | IReq_ControllerProjectSuggest
+  | IReq_ControllerProviderList
+  | IReq_ControllerProviderConnectionList
+  | IReq_ControllerProviderConnectionActivateOpenCode
+  | IReq_ControllerProviderLoginBegin
+  | IReq_ControllerProviderLoginGet
+  | IReq_ControllerProviderLoginCancel
+  | IReq_ControllerProviderConnectionLogout
+  | IReq_ControllerProviderConnectionRateLimitsGet
+  | IReq_ControllerProviderModelRefreshBegin
+  | IReq_ControllerProviderModelRefreshGet
+  | IReq_ControllerSlashList
+  | IReq_ControllerSlashExecute
+  | IReq_ControllerModelList
+  | IReq_ControllerSettingsGet
+  | IReq_ControllerSettingsUpdate
+  | IReq_ControllerSessionList
+  | IReq_ControllerSessionGet
+  | IReq_ControllerSessionAuxiliaryGet
+  | IReq_ControllerSessionModelUpdate
+  | IReq_ControllerSessionScratchpadSave
+  | IReq_ControllerSessionIntelligenceAsk
+  | IReq_ControllerSessionMessagesPage
+  | IReq_ControllerSessionMessageGet
+  | IReq_ControllerSessionCreate
+  | IReq_ControllerSessionDelete
+  | IReq_ControllerSessionDiscardEmpty
+  | IReq_ControllerSessionDraftGet
+  | IReq_ControllerSessionDraftUpdate
+  | IReq_ControllerSessionSend
+  | IReq_ControllerSessionAbort
+  | IReq_ControllerPermissionReply
+  | IReq_ControllerQuestionReply
+  | IReq_ControllerSessionRename
+  | IReq_ControllerSessionArchive
+  | IReq_ControllerSessionGroupsGet
+  | IReq_ControllerSessionGroupsUpdate
+  | IReq_ControllerSessionYolo
+  | IReq_ControllerResourceList
+  | IReq_ControllerResourceCreate
+  | IReq_ControllerResourceRename
+  | IReq_ControllerResourceAttach
+  | IReq_ControllerResourceDetach
+  | IReq_ControllerResourceRetire
+  | IReq_ControllerResourceStart
+  | IReq_ControllerResourceStop
+  | IReq_ControllerBrowserViewOpen
+  | IReq_ControllerBrowserViewActivate
+  | IReq_ControllerBrowserViewClose
+  | IReq_ControllerBrowserViewOperate
+  | IReq_ControllerTerminalList
+  | IReq_ControllerTerminalCreate
+  | IReq_ControllerTerminalRename
+  | IReq_ControllerTerminalRemove
+  | IReq_ControllerTerminalAttach
+  | IReq_ControllerTerminalDetach
+  | IReq_ControllerTerminalInput
+  | IReq_ControllerTerminalResize
+  | IReq_ControllerTerminalOutput
+  | IReq_ControllerBrowserViewEvent
+  | IReq_ControllerEvent;