Archived
Federico Jaramillo Martinez
cfa9f5a2fa
# Conflicts: # docs/config.html # docs/config.md # src/cli.test.ts # src/cli.ts # src/client/src/components/settings/SettingsSessiondPanel.ts # src/client/src/components/settings/settingsConfigDraft.test.ts # src/client/src/components/settings/settingsConfigDraft.ts # src/server/app.test.ts # src/server/app.ts # src/server/configRoutes.test.ts # src/server/configRoutes.ts # src/server/piWebPluginService.test.ts # src/server/piWebPluginService.ts # src/server/piWebStatus.test.ts # src/server/piWebStatus.ts # src/server/piWebStatusCache.ts # src/server/sessions/authService.test.ts # src/server/sessions/piSessionService.ts # src/server/sessions/sessionRoutes.test.ts
62 lines
3.2 KiB
TypeScript
62 lines
3.2 KiB
TypeScript
import type {
|
|
SavedPromptAttachment,
|
|
SessionBulkArchiveResponse,
|
|
SessionBulkDeleteArchivedResponse,
|
|
SessionBulkMutationRef,
|
|
} from "../../shared/apiTypes.js";
|
|
import type {
|
|
ClientArchiveSessionsResponse,
|
|
ClientCommand,
|
|
ClientCommandResult,
|
|
ClientMessagePage,
|
|
ClientSession,
|
|
ClientSessionCleanupExecuteResponse,
|
|
ClientSessionCleanupPreviewResponse,
|
|
ClientSessionModel,
|
|
ClientSessionRef,
|
|
ClientSessionStatus,
|
|
ClientThinkingLevel,
|
|
} from "../types.js";
|
|
import type { NormalizedSessionCleanupRequest } from "./sessionCleanup.js";
|
|
|
|
export type SessionRouteRef = ClientSessionRef;
|
|
export type SessionRouteLookup = string | SessionRouteRef;
|
|
|
|
/**
|
|
* Route-facing session contract for PI WEB's HTTP/WebSocket API.
|
|
*
|
|
* Keep this surface neutral: implementations may be backed by the native Pi SDK,
|
|
* an out-of-process agent bridge, or another daemon. Pi-specific lifecycle hooks
|
|
* such as auth-change handling and daemon shutdown stay on the concrete service.
|
|
*/
|
|
export interface SessionRouteService {
|
|
list(cwd: string): Promise<ClientSession[]>;
|
|
start(cwd: string): Promise<ClientSession>;
|
|
messages(ref: SessionRouteLookup, page?: { before?: number; limit?: number }): Promise<unknown[] | ClientMessagePage>;
|
|
status(ref: SessionRouteLookup): Promise<ClientSessionStatus>;
|
|
availableModels(ref: SessionRouteLookup): Promise<ClientSessionModel[]>;
|
|
setModel(ref: SessionRouteLookup, provider: string, modelId: string): Promise<ClientSessionStatus>;
|
|
cycleModel(ref: SessionRouteLookup, direction: "forward" | "backward"): Promise<ClientSessionStatus>;
|
|
availableThinkingLevels(ref: SessionRouteLookup): Promise<ClientThinkingLevel[]>;
|
|
setThinkingLevel(ref: SessionRouteLookup, level: string): Promise<ClientSessionStatus>;
|
|
cycleThinkingLevel(ref: SessionRouteLookup): Promise<ClientSessionStatus>;
|
|
commands(ref: SessionRouteLookup): Promise<ClientCommand[]>;
|
|
prompt(ref: SessionRouteLookup, text: unknown, streamingBehavior?: unknown, attachments?: unknown): Promise<void>;
|
|
saveAttachments(ref: SessionRouteLookup, attachments: unknown, folder?: string): Promise<SavedPromptAttachment[]>;
|
|
cleanupPreview(request: NormalizedSessionCleanupRequest): Promise<ClientSessionCleanupPreviewResponse>;
|
|
cleanup(request: NormalizedSessionCleanupRequest): Promise<ClientSessionCleanupExecuteResponse>;
|
|
archiveMany(refs: readonly SessionBulkMutationRef[]): Promise<SessionBulkArchiveResponse>;
|
|
deleteArchivedMany(refs: readonly SessionBulkMutationRef[]): Promise<SessionBulkDeleteArchivedResponse>;
|
|
shell(ref: SessionRouteLookup, text: string): Promise<void>;
|
|
runCommand(ref: SessionRouteLookup, text: string): Promise<ClientCommandResult>;
|
|
respondToCommand(ref: SessionRouteLookup, requestId: string, value: string): Promise<ClientCommandResult>;
|
|
abort(ref: SessionRouteLookup): Promise<void>;
|
|
stop(ref: SessionRouteLookup): void | Promise<void>;
|
|
archive(ref: SessionRouteLookup): Promise<void>;
|
|
archiveTree(ref: SessionRouteLookup): Promise<ClientArchiveSessionsResponse>;
|
|
restore(ref: SessionRouteLookup): Promise<void>;
|
|
deleteArchived(ref: SessionRouteLookup): Promise<void>;
|
|
reload(ref: SessionRouteLookup): Promise<void>;
|
|
detachParent(ref: SessionRouteLookup): Promise<void>;
|
|
}
|