dsh-lowtide 0.1.2

package/lib/types/client/api.d.ts

@@ -0,0 +1,169 @@
+/**
+ * HTTP helpers for the /ds-lowtide API (same-origin fetch).
+ * Optimistic-write callers handle rollback; these helpers just carry the wire.
+ */
+export interface EstimateResponse {
+    ok: boolean;
+    peak: number;
+    off: number;
+    model: string;
+    batchModel?: string;
+}
+export interface TaskResponse {
+    ok: boolean;
+    task?: import('./store.ts').HostTask;
+    error?: string;
+}
+export declare function estimate(prompt: string, files: {
+    size: number;
+}[], model?: string, batchModel?: string): Promise<EstimateResponse>;
+export declare function submitTask(input: {
+    prompt: string;
+    files: string[];
+    workspace: string;
+    priority: number;
+    permissionPreset: string;
+    strategy?: 'single' | 'iterative' | 'sampling' | 'review';
+    rounds?: number;
+    reasoning?: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    /** Task-level batch model override (advanced window; absent = follows default). */
+    model?: string;
+    /** Provider for the task-level model override (absent = follows the live selection). */
+    modelProvider?: string;
+    strategyHint?: string;
+    /** Per-task autonomy override (new-task modal); absent = follow global. */
+    autonomy?: 'l1' | 'l2' | 'l3';
+}): Promise<TaskResponse>;
+export declare function triage(id: string, action: 'approve' | 'defer' | 'drop' | 'cancel'): Promise<unknown>;
+/** 采样任务的次日择优:记录用户选定的候选序号。 */
+export declare function chooseCandidate(id: string, index: number): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Hard-delete a task for good (as opposed to the soft `drop` triage). */
+export declare function deleteTask(id: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** 重新执行:清错误重新入队,下次窗口或「立即开跑」时执行。 */
+export declare function retryTask(id: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** 恢复已放弃:dropped → pending-review,由用户重新裁定。 */
+export declare function restoreTask(id: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function approveAll(): Promise<{
+    ok: boolean;
+    approved: number;
+}>;
+/** 清空已完成:删除全部 done 任务(执行报告历史保留证据)。 */
+export declare function clearFinished(): Promise<{
+    ok: boolean;
+    cleared?: number;
+    error?: string;
+}>;
+export declare function runNow(): Promise<{
+    ok: boolean;
+}>;
+export declare function dismissPeakToday(): Promise<{
+    ok: boolean;
+}>;
+export interface ConfigResponse {
+    ok: boolean;
+    config?: Record<string, unknown>;
+    error?: string;
+}
+import type { HostReport } from './store.ts';
+export interface ReportsResponse {
+    ok: boolean;
+    reports?: HostReport[];
+    total?: number;
+    /** maxReportHistory (0 = unlimited) — for the "showing latest N" label. */
+    limit?: number;
+    error?: string;
+}
+/** Morning-report history (newest first). */
+export declare function getReports(): Promise<ReportsResponse>;
+/** Delete a single report by id (ledger and tasks are untouched). */
+export declare function deleteReport(reportId: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Clear all reports. Returns how many were removed. */
+export declare function clearReports(): Promise<{
+    ok: boolean;
+    cleared?: number;
+    error?: string;
+}>;
+/** Real user conversations per workspace (for the "continue from a
+ *  conversation" picker). Read-only scan of the dsh storage files. */
+export interface WorkspaceSessionEntry {
+    id: string;
+    title: string | null;
+    lastModified: number;
+}
+export interface WorkspaceSessionsEntry {
+    cwd: string;
+    label: string | null;
+    sessions: WorkspaceSessionEntry[];
+}
+export interface SessionsResponse {
+    ok: boolean;
+    workspaces?: WorkspaceSessionsEntry[];
+    error?: string;
+}
+export declare function getSessions(): Promise<SessionsResponse>;
+/** All registered DSH workspaces (for the task form workspace picker). */
+export interface WorkspaceEntry {
+    path: string;
+    title: string | null;
+}
+export interface WorkspacesResponse {
+    ok: boolean;
+    workspaces?: WorkspaceEntry[];
+    error?: string;
+}
+export declare function getWorkspaces(): Promise<WorkspacesResponse>;
+/** All models available on this machine (deepseek + any llm-pi-ai). */
+export interface AvailableModel {
+    id: string;
+    name: string;
+    priceKnown: boolean;
+    inputModalities?: string[];
+    reasoningEfforts?: string[];
+    defaultReasoningEffort?: string;
+}
+export interface AvailableProvider {
+    provider: string;
+    displayName: string;
+    models: AvailableModel[];
+}
+export interface ModelsResponse {
+    ok: boolean;
+    providers?: AvailableProvider[];
+    error?: string;
+}
+export declare function getModels(): Promise<ModelsResponse>;
+/** Read the full lowtide config (settings page seed). */
+export declare function getConfig(): Promise<ConfigResponse>;
+/** Settings-page meta from the live state: system timezone + official peak
+ *  windows converted to the local clock (explainer + one-click adopt). */
+export declare function getStateMeta(): Promise<{
+    ok: boolean;
+    systemTz?: string;
+    officialInLocal?: Array<{
+        label: string;
+        start: string;
+        end: string;
+        crossesDay: boolean;
+        days?: number[];
+    }>;
+    error?: string;
+}>;
+/** Persist a partial config update; takes effect immediately (next scheduler tick). */
+export declare function updateConfig(patch: Record<string, unknown>): Promise<ConfigResponse>;
+export declare function lastWorkspace(): string;
+export declare function rememberWorkspace(path: string): void;

package/lib/types/client/components/CandidatesView.d.ts

@@ -0,0 +1,8 @@
+import { type HostCandidate } from '../store.ts';
+import { type NsTranslate } from '../i18n.ts';
+export declare function CandidatesView({ candidates, chosenIndex, taskId, t }: {
+    candidates: HostCandidate[];
+    chosenIndex?: number;
+    taskId: string;
+    t: NsTranslate;
+}): React.JSX.Element;

package/lib/types/client/components/ConfirmGate.d.ts

@@ -0,0 +1,6 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type NsTranslate } from '../i18n.ts';
+export type ConfirmGateProps = PropsRuntime<'shell.overlay'> & {
+    t: NsTranslate;
+};
+export declare function ConfirmGate({ t }: ConfirmGateProps): React.JSX.Element;

package/lib/types/client/components/DroppedRow.d.ts

@@ -0,0 +1,6 @@
+import { type HostTask } from '../store.ts';
+import { type NsTranslate } from '../i18n.ts';
+export declare function DroppedRow({ task, t }: {
+    task: HostTask;
+    t: NsTranslate;
+}): React.JSX.Element;

package/lib/types/client/components/InterceptCard.d.ts

@@ -0,0 +1,17 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ComposerChainProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { type NsTranslate } from '../i18n.ts';
+export interface InterceptMatched {
+    kind: 'lt-intercept';
+}
+/**
+ * Pure chain routing: priced window ∧ not dismissed ∧ session present ∧
+ * draft non-empty. The draft condition keeps the native bar (and the queue
+ * dock) visible until the user actually starts typing (PLAN §6.2).
+ */
+export declare function selectIntercept(owner: ComposerChainProps): InterceptMatched | null;
+export type InterceptCardProps = PropsRuntime<'conversation.composer'> & {
+    matched: InterceptMatched;
+    t: NsTranslate;
+};
+export declare function InterceptCard(props: InterceptCardProps): React.JSX.Element;

package/lib/types/client/components/MorningReport.d.ts

@@ -0,0 +1,6 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type NsTranslate } from '../i18n.ts';
+export type MorningReportProps = PropsRuntime<'shell.overlay'> & {
+    t: NsTranslate;
+};
+export declare function MorningReport({ t }: MorningReportProps): React.JSX.Element;

package/lib/types/client/components/NewTaskModal.d.ts

@@ -0,0 +1,9 @@
+import { type NsTranslate } from '../i18n.ts';
+import { type AutonomyId } from './TaskForm.tsx';
+export declare function NewTaskModal({ open, t, defaultAutonomy, onClose }: {
+    open: boolean;
+    t: NsTranslate;
+    /** Global autonomy from the live state — the button group starts here. */
+    defaultAutonomy: AutonomyId;
+    onClose: () => void;
+}): React.JSX.Element;

package/lib/types/client/components/PriceBand.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PriceBand: 24h price-band preview — 48 cells (30 min each) colored by the
+ * given segments, local-time axis labels, and a "now" marker. Shared by the
+ * settings page and the pill's window editor (callers own the fallback: pass
+ * official-in-local segments when nothing custom is configured).
+ */
+import { type NsTranslate } from '../i18n.ts';
+export interface BandSegment {
+    level: 'peak' | 'off' | 'custom';
+    start: string;
+    end: string;
+}
+export declare function PriceBand({ segments, nowIndex, t }: {
+    segments: BandSegment[];
+    nowIndex: number;
+    t: NsTranslate;
+}): React.JSX.Element;

package/lib/types/client/components/PricePill.d.ts

@@ -0,0 +1,8 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type NsTranslate } from '../i18n.ts';
+export type PricePillProps = PropsRuntime<'conversation.session.header.utilities'> & {
+    t: NsTranslate;
+};
+export declare function PricePill({ t }: PricePillProps): React.JSX.Element;
+/** Saved-today number for the tooltip (reused by the dock footer). */
+export declare function SavedToday(): React.JSX.Element;

package/lib/types/client/components/QueueDock.d.ts

@@ -0,0 +1,8 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type NsTranslate } from '../i18n.ts';
+import { NewTaskModal } from './NewTaskModal.tsx';
+export type QueueDockProps = PropsRuntime<'conversation.input.dock'> & {
+    t: NsTranslate;
+};
+export declare function QueueDock(props: QueueDockProps): React.JSX.Element;
+export { NewTaskModal };

package/lib/types/client/components/TaskDetail.d.ts

@@ -0,0 +1,7 @@
+import { type HostTask } from '../store.ts';
+import { type NsTranslate } from '../i18n.ts';
+export declare function TaskDetail({ task, t, onClose }: {
+    task: HostTask;
+    t: NsTranslate;
+    onClose: () => void;
+}): React.JSX.Element;

package/lib/types/client/components/TaskForm.d.ts

@@ -0,0 +1,85 @@
+/**
+ * TaskForm (Phase D + v3.1 + v3.2): the single source of truth for task
+ * intake fields.
+ *
+ * A fully CONTROLLED presentational component — the caller owns the state:
+ *  - NewTaskModal (variant="modal") holds local state and submits via the
+ *    task API; it also owns `advancedOpen` (the separate advanced window);
+ *  - InterceptCard (variant="intercept") binds the prompt to the host input
+ *    store (inputActions.setDraft) and keeps the workspace in local state.
+ *
+ * modal:     prompt (placeholder follows the strategy) + workspace/priority
+ *            side by side + strategy (plain pills, hover tooltips, dynamic
+ *            explanation line, rounds for iterative/sampling, per-strategy
+ *            guidance text) + permission + an "advanced" gear button that
+ *            opens a separate SMALL WINDOW (reasoning effort, locked files).
+ * intercept: prompt + workspace + empty-workspace warning only — the quick
+ *            enqueue surface stays minimal.
+ */
+import type { ReactElement } from 'react';
+import { type NsTranslate } from '../i18n.ts';
+export type StrategyId = 'single' | 'iterative' | 'sampling' | 'review';
+export type ReasoningId = 'follow' | 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export type AutonomyId = 'l1' | 'l2' | 'l3';
+export type SessionModeId = 'new' | 'continue';
+export type TaskModelId = string;
+export interface TaskFormModel {
+    id: string;
+    name: string;
+    provider: string;
+    reasoningEfforts?: string[];
+    defaultReasoningEffort?: string;
+}
+/** A dsh conversation stored under a workspace (from GET /sessions). */
+export interface SessionWorkspace {
+    cwd: string;
+    label: string | null;
+    sessions: Array<{
+        id: string;
+        title: string | null;
+        lastModified: number;
+    }>;
+}
+export interface TaskFormValues {
+    prompt: string;
+    workspace: string;
+    strategy: StrategyId;
+    rounds: number;
+    priority: number;
+    files: string;
+    reasoning: ReasoningId;
+    /** Task-level batch model (advanced window; '' = follow the live selection). */
+    model: TaskModelId;
+    /** Provider for the task-level model (advanced window; '' = follow the live selection). */
+    modelProvider: string;
+    strategyHint: string;
+    /** Per-task autonomy override; defaults to the global config value. */
+    autonomy: AutonomyId;
+    /** new = standalone session; continue = resume a dsh conversation. */
+    sessionMode: SessionModeId;
+    /** Historical dsh session id when sessionMode === 'continue'. */
+    continuesFromSession?: string;
+}
+/** Relative "x min/h ago" label for a session's last activity; falls back
+ *  to an absolute "MM-DD HH:mm" label once the session is a day old. */
+export declare function sessionTimeLabel(lastModified: number, t: NsTranslate): string;
+export declare function TaskForm(props: {
+    t: NsTranslate;
+    variant: 'modal' | 'intercept';
+    values: TaskFormValues;
+    onChange(patch: Partial<TaskFormValues>): void;
+    autoFocusPrompt?: boolean;
+    /** Modal variant only: the separate advanced window (v3.2). */
+    advancedOpen?: boolean;
+    onAdvancedOpenChange?(open: boolean): void;
+    /** Modal variant only: real conversations per workspace for the
+     *  "continue from a conversation" mode (from GET /sessions). */
+    sessionWorkspaces?: SessionWorkspace[];
+    /** Available models from GET /ds-lowtide/models (flattened for the UI). */
+    models?: TaskFormModel[];
+    /** Registered DSH workspaces from GET /ds-lowtide/workspaces. */
+    workspaces?: Array<{
+        path: string;
+        title: string | null;
+    }>;
+}): ReactElement;

package/lib/types/client/components/TaskRow.d.ts

@@ -0,0 +1,7 @@
+import { type HostTask } from '../store.ts';
+import { type NsTranslate } from '../i18n.ts';
+export declare function TaskRow({ task, t, onOpenDetail }: {
+    task: HostTask;
+    t: NsTranslate;
+    onOpenDetail: (task: HostTask) => void;
+}): React.JSX.Element;

package/lib/types/client/components/WindowEditorModal.d.ts

@@ -0,0 +1,6 @@
+import { type NsTranslate } from '../i18n.ts';
+export declare function WindowEditorModal({ open, onClose, t }: {
+    open: boolean;
+    onClose: () => void;
+    t: NsTranslate;
+}): React.JSX.Element;

package/lib/types/client/components/atoms.d.ts

@@ -0,0 +1,25 @@
+/** ¥3.82 two-decimals; ¥123 without decimals at ≥¥100; <¥0.01 for dust (PLAN §3.6). */
+export declare function Money({ yuan, className }: {
+    yuan: number;
+    className?: string;
+}): React.JSX.Element;
+/** HH:MM:SS live countdown to a timestamp (local interval, no network). */
+export declare function Countdown({ targetMs, className }: {
+    targetMs: number;
+    className?: string;
+}): React.JSX.Element;
+/** HH:MM from a timestamp. */
+export declare function ClockTime({ ms, className }: {
+    ms: number;
+    className?: string;
+}): React.JSX.Element;
+export type LevelState = 'peak' | 'off' | 'running' | 'ending';
+/** StateDot mapping: red peak / green off / amber window-ending / blue-pulse running. */
+export declare function LevelDot({ state }: {
+    state: LevelState;
+}): React.JSX.Element;
+/** Small tag showing which model a task uses. Optionally flags unknown pricing. */
+export declare function ModelBadge({ model, priceKnown }: {
+    model?: string;
+    priceKnown?: boolean;
+}): React.JSX.Element | null;

package/lib/types/client/hooks/useInterceptDraft.d.ts

@@ -0,0 +1,13 @@
+export declare const INTERCEPT_DISMISS_KEY = "dsh-lowtide:intercept-session-dismissed";
+/** Sync the live draft into the module state (QueueDock stays mounted inside
+ * the overlay-kept fallback, so it keeps tracking while the card is up).
+ * An emptied draft re-arms interception for the next message. */
+export declare function useInterceptDraftTracking(draft: string): void;
+/** Pure read for the chain selector. */
+export declare function readInterceptDraft(): string;
+/** ✕ exemption: this message will not be intercepted again this session. */
+export declare function dismissInterceptSession(): void;
+/** Clear the per-session exemption (new message = re-arm). */
+export declare function clearInterceptSessionDismissal(): void;
+/** Pure read for the chain selector. */
+export declare function isInterceptSessionDismissed(): boolean;