@prismshadow/penguin-server 0.1.0 → 0.1.2

package/dist/api/types.d.ts

@@ -48,6 +48,15 @@ interface AuthResponse {
 }
 interface MeResponse {
     user: UserInfo;
+    /**
+     * Whether Workspace HTML previews open on a separate origin (see design §
+     * "Workspace 文件预览"). False means this deployment has no usable preview origin —
+     * the App is reached on something other than a loopback name and
+     * PENGUIN_PREVIEW_ORIGIN is unset — so previews fall back to the same-origin sandbox,
+     * where `localStorage`, cookies and third-party embeds do not work. Computed per
+     * request, since it depends on the host the caller is using.
+     */
+    previewIsolated: boolean;
 }
 interface PasswordChangeRequest {
     oldPassword: string;
@@ -159,6 +168,13 @@ interface ModelInfo {
      * unset (= treated as supported).
      */
     vision?: boolean;
+    /**
+     * Per-model max output tokens (TOML `max_tokens` annotation; user-only, never preset by the
+     * built-in catalog): when set it wins over the Agent's `system_config.model.max_tokens`;
+     * unset = inherit the Agent value. Lets a small-context model cap its output below the
+     * seeded per-Agent default (32000), which cannot fit into e.g. a 32k context window.
+     */
+    maxTokens?: number;
     pricing?: ModelPricingDto;
     /** Environment variable name to fall back to when api_key is empty (e.g. ANTHROPIC_API_KEY); unset if no known fallback. */
     envKey?: string;
@@ -192,6 +208,8 @@ interface ModelUpdateEntry {
     clientType?: string;
     /** Whether image input (vision/multimodal) is supported; omitted = supported (not persisted). */
     vision?: boolean;
+    /** Per-model max output tokens, a positive integer (wins over the Agent config); omitted = inherit the Agent value (the annotation is cleared). */
+    maxTokens?: number;
     pricing?: ModelPricingDto;
     /** Providing it overwrites and updates createdAt; omitting it keeps the existing value. */
     apiKey?: string;
@@ -367,19 +385,46 @@ interface SessionInfo {
     approvalMode: ApprovalMode;
     /** Short title auto-generated by the model after the first turn; unset until generated (frontend shows "New Chat"). */
     title?: string;
-    /** Session source (for list badges); unset for user-created sessions. */
+    /** Session source (for list badges/folders), derived from core session_meta — the single source of truth (not stored in the DB); unset for user-created sessions. */
     source?: SessionSource;
     createdAt: string;
     status: SessionStatus;
     /** Number of approvals awaiting human decision (a persisted count outside server events, for list badges). */
     pendingApprovalCount: number;
+    /** Number of queued follow-up tasks (`queueIfBusy`) awaiting auto-start once the session is idle. */
+    pendingFollowUpCount: number;
     /** Whether a Trace record exists (a Task has been started). */
     hasTrace: boolean;
     /** Whether archived (hidden from the default list, grouped under "Archived"). */
     archived: boolean;
+    /**
+     * Absolute path of the session's latest Trace file (the current context shard); absent
+     * when no Trace exists yet. Populated on the **single-session GET only** — list rows omit
+     * it (locating it costs a directory walk per Session). The web's `/model` switch puts it
+     * into the new session's `[model_switch_from]` block so the model can read the source
+     * history itself when it needs it.
+     */
+    tracePath?: string;
 }
+/**
+ * Session list category, the sidebar's four-way split applied server-side: archived wins
+ * regardless of origin (archiving is an explicit user action), then the origin's bucket,
+ * and a Session with no (or an unknown) source is `active` — user-created rows.
+ */
+type SessionCategory = "active" | SessionSource | "archived";
+/** Per-category totals across an Agent's whole Session list (returned when the list is requested with counts). */
+type SessionCategoryCounts = Record<SessionCategory, number>;
 interface SessionsResponse {
     sessions: SessionInfo[];
+    /** Present when the request asked for counts (`counts=1`): totals per category over the full list, not just the returned page. */
+    counts?: SessionCategoryCounts;
+    /**
+     * Present with `counts`: the same totals broken down by Workspace path (only paths
+     * with at least one Session appear). The sidebar's workspace grouping decides each
+     * group's folders and "More" from its own share, so a group never advertises
+     * content that lives in other Workspaces.
+     */
+    workspaceCounts?: Record<string, SessionCategoryCounts>;
 }
 /** Server directory browsing (advanced new-Workspace picker): starts from the home directory by default, can navigate up to the root. */
 interface DirEntryInfo {
@@ -439,10 +484,35 @@ type TaskInputPart = {
 };
 interface TaskCreateRequest {
     input: TaskInputPart[];
+    /**
+     * Thinking level for this Task's LLM requests (a per-turn parameter; one of
+     * `none | low | medium | high | xhigh`, anything else is a 400). Omitted = falls back to
+     * the session's default (the Agent config's `model.thinking_level`). A queued follow-up
+     * (`queueIfBusy`) keeps its level and applies it when it auto-starts.
+     */
+    thinkingLevel?: ThinkingLevelName;
+    /**
+     * Queue instead of 409 when a Task/compaction is already in progress: the input is held
+     * server-side and auto-starts as an ordinary next task once the session returns to idle
+     * (in queue order, one at a time). The response then carries `queued: true`.
+     */
+    queueIfBusy?: boolean;
 }
 interface TaskCreateResponse {
     /** Current actual session_id: a Trace-less invalid Session self-heals and returns a new id; the frontend updates its route accordingly. */
     sessionId: string;
+    /** True when `queueIfBusy` enqueued the input as a follow-up instead of starting it (absent/false: the task started). */
+    queued?: boolean;
+}
+/**
+ * Mid-run steering (POST /api/sessions/:id/steer): a user message for the **running** Task,
+ * delivered by core between turns as a standalone `[user_steering]` user message. 202 on
+ * queue; 409 `not_running` when no Task is in progress (the frontend falls back to a normal
+ * task POST).
+ */
+interface SteerRequest {
+    /** Non-empty message text (trimmed server-side). */
+    text: string;
 }
 interface ApprovalDecisionRequest {
     decision: "allow" | "deny";
@@ -458,10 +528,11 @@ type ServerEvent =
     toolCall: OmniMessage<ToolCallPayload>;
     origin?: string[];
 }
-/** Session run status flip (for toggling the input area and list). */
+/** Session run status flip (for toggling the input area and list); `queued` = queued follow-up count (see TaskCreateRequest.queueIfBusy). */
  | {
     type: "task_state";
     state: SessionStatus;
+    queued?: number;
 }
 /** The model-generated title after the first turn has been persisted (for in-place list updates). */
  | {
@@ -573,7 +644,7 @@ interface TraceTaskStats {
     /**
      * This turn's duration span: `startTs` = the moment of this turn's **first `request_begin`**
      * — duration only looks at LLM requests, not the timestamp of user text like the user
-     * Prompt / compaction summary (`<context_summary>` is created during compaction but only
+     * Prompt / compaction summary (`[context_summary]` is created during compaction but only
      * persisted on the next run; resuming the next day would inflate the first turn by a whole
      * day for no reason); `endTs` = the moment of the last non-session_meta message in the
      * range. For a degenerate turn with no Request at all (interrupted right after sending),
@@ -975,4 +1046,4 @@ interface SkillInstallRequest {
     names: string[];
 }
 
-export type { AdminPasswordResetRequest, AdminUserCreateRequest, AdminUserCreateResponse, AdminUsersResponse, AgentCompactionConfigDto, AgentConfigDto, AgentConfigResponse, AgentConfigUpdateRequest, AgentCreateRequest, AgentCreateResponse, AgentImportRequest, AgentImportResponse, AgentModelConfigDto, AgentSkillsResponse, AgentSummary, AgentTraceDateGroup, AgentTraceFileRef, AgentTraceSessionGroup, AgentTracesResponse, AgentsResponse, ApprovalDecisionRequest, ApprovalMode, AuthLoginRequest, AuthResponse, BenchmarkCaseScore, BenchmarkEvaluation, BenchmarkRunScore, BenchmarkSummary, BenchmarksResponse, CredentialInfo, DirEntryInfo, DirListResponse, ErrorBody, FilesStatRequest, FilesStatResponse, MeResponse, MemberAddRequest, MemberAddResponse, MemberInfo, MembersResponse, MessagesResponse, ModelInfo, ModelPricingDto, ModelRefDto, ModelTestRequest, ModelTestResponse, ModelUpdateEntry, ModelsResponse, ModelsUpdateRequest, PasswordChangeRequest, PrefsResponse, ProjectCreateRequest, ProjectCreateResponse, ProjectRole, ProjectSummary, ProjectsResponse, RequestSpan, ScheduleItem, ScheduleServerEvent, ScheduleStatus, ScheduleUpsertRequest, SchedulesResponse, ServerEvent, SessionCreateRequest, SessionCreateResponse, SessionInfo, SessionPatchRequest, SessionResponse, SessionSource, SessionStatus, SessionTracesResponse, SessionsResponse, SkillGroupItem, SkillInstallRequest, SkillLibraryResponse, SkillMetadataItem, TaskCreateRequest, TaskCreateResponse, TaskInputPart, ToolCallSpan, TraceAnalysisResponse, TraceEventsResponse, TraceFileInfo, TraceModelSegment, TraceTaskStats, TraceToolSpan, UiPrefs, UsageAgentCount, UsageBucket, UsageErrorCount, UsageErrorItem, UsageErrors, UsageGroupBy, UsageGroupRow, UsageResponse, UsageSuccessRate, UsageTrendPoint, UsageTrendPointInTrace, UserInfo, VaultEntryInfo, VaultEntryUpdate, VaultResponse, VaultUpdateRequest, WorkspaceFileEntry, WorkspaceFilesResponse };
+export type { AdminPasswordResetRequest, AdminUserCreateRequest, AdminUserCreateResponse, AdminUsersResponse, AgentCompactionConfigDto, AgentConfigDto, AgentConfigResponse, AgentConfigUpdateRequest, AgentCreateRequest, AgentCreateResponse, AgentImportRequest, AgentImportResponse, AgentModelConfigDto, AgentSkillsResponse, AgentSummary, AgentTraceDateGroup, AgentTraceFileRef, AgentTraceSessionGroup, AgentTracesResponse, AgentsResponse, ApprovalDecisionRequest, ApprovalMode, AuthLoginRequest, AuthResponse, BenchmarkCaseScore, BenchmarkEvaluation, BenchmarkRunScore, BenchmarkSummary, BenchmarksResponse, CredentialInfo, DirEntryInfo, DirListResponse, ErrorBody, FilesStatRequest, FilesStatResponse, MeResponse, MemberAddRequest, MemberAddResponse, MemberInfo, MembersResponse, MessagesResponse, ModelInfo, ModelPricingDto, ModelRefDto, ModelTestRequest, ModelTestResponse, ModelUpdateEntry, ModelsResponse, ModelsUpdateRequest, PasswordChangeRequest, PrefsResponse, ProjectCreateRequest, ProjectCreateResponse, ProjectRole, ProjectSummary, ProjectsResponse, RequestSpan, ScheduleItem, ScheduleServerEvent, ScheduleStatus, ScheduleUpsertRequest, SchedulesResponse, ServerEvent, SessionCategory, SessionCategoryCounts, SessionCreateRequest, SessionCreateResponse, SessionInfo, SessionPatchRequest, SessionResponse, SessionSource, SessionStatus, SessionTracesResponse, SessionsResponse, SkillGroupItem, SkillInstallRequest, SkillLibraryResponse, SkillMetadataItem, SteerRequest, TaskCreateRequest, TaskCreateResponse, TaskInputPart, ToolCallSpan, TraceAnalysisResponse, TraceEventsResponse, TraceFileInfo, TraceModelSegment, TraceTaskStats, TraceToolSpan, UiPrefs, UsageAgentCount, UsageBucket, UsageErrorCount, UsageErrorItem, UsageErrors, UsageGroupBy, UsageGroupRow, UsageResponse, UsageSuccessRate, UsageTrendPoint, UsageTrendPointInTrace, UserInfo, VaultEntryInfo, VaultEntryUpdate, VaultResponse, VaultUpdateRequest, WorkspaceFileEntry, WorkspaceFilesResponse };