@maudecode/talaria-web 1.20.0 → 1.22.0

package/dist/sessions/service.d.ts

@@ -1,4 +1,5 @@
-import { type ContextDetail } from '@maudecode/talaria-web-contracts';
+import { type SessionActivityPhase, type ContextDetail } from '@maudecode/talaria-web-contracts';
+import { SessionPrefixIndex } from './prefix-index.js';
 /**
  * Route-level session operations (the Python `/api/session*` handlers): the
  * detail payload, list and search, and every mutation with its guards.
@@ -6,6 +7,7 @@ import { type ContextDetail } from '@maudecode/talaria-web-contracts';
  */
 import type { AgentStorage, ChatReadiness, PendingSteer, RecoveryAudit, RunStatus, SessionGoal, SessionNotice, RecoveryRepair, SidecarResult } from '@maudecode/talaria-web-contracts';
 import type { RunJournal } from './journal.js';
+import type { OutboundDraft, OutboundDraftAction, OutboundDraftRef } from '@maudecode/talaria-web-contracts';
 import type { DraftStore } from './drafts.js';
 import type { SessionEventBus } from './events.js';
 import { type ListParams, type ListResponse, type Row, type RuntimeOverlay } from './list.js';
@@ -61,6 +63,10 @@ export interface SessionServiceDeps {
     /** A profile whose deletion has started takes no new detached work. */
     profileDeleting?: (profile: string | null) => boolean;
     /** TAL-372: the session's background work receipts, for the delegation rows that started them. */
+    sessionActivity?: (sid: string, profile: string | null, opts?: {
+        excludeStreamId?: string;
+        terminalPhase?: SessionActivityPhase;
+    }) => Promise<SessionActivityPhase>;
     backgroundReceipts?: (sid: string) => Receipt[] | Promise<Receipt[]>;
     backgroundPending?: (sid: string) => Promise<Set<string>>;
     store: SessionStore;
@@ -77,6 +83,7 @@ export interface SessionServiceDeps {
     /** The agent's display name for a session's profile (`assistant_name`). */
     assistantName: (profile: string | null) => string;
     redactEnabled: () => boolean;
+    showReasoning?: (profile: string | null) => Promise<boolean>;
     pinnedSessionsLimit: () => number;
     runtime: RuntimeOverlay & {
         /** A live worker stream that must block deletion / duplicate turns for this session. */
@@ -348,6 +355,10 @@ export declare class SessionService {
     publicSession(s: Session, withMessages?: boolean, messages?: Message[]): Promise<Record<string, unknown>>;
     /** Opaque read identity, including context changes that do not alter display message counts. */
     private contextDetailKey;
+    activityPhase(s: Session, opts?: {
+        excludeStreamId?: string;
+        terminalPhase?: SessionActivityPhase;
+    }): Promise<SessionActivityPhase | undefined>;
     /** `compact()` with the wire streaming/read-only flags (TAL-312), for replies that return the session row. */
     wireRow(s: Session): Promise<Record<string, unknown>>;
     /**
@@ -364,10 +375,13 @@ export declare class SessionService {
     /** The agent's display name for a session's profile (`assistant_name`). */
     assistantName(s: Session): string;
     /** Python `public_session_projection(s.__dict__)`: every persisted field, redacted (session export). */
-    publicSessionDocument(s: Session): Record<string, unknown>;
+    publicSessionDocument(s: Session): Promise<Record<string, unknown>>;
+    /** One server decision for history, mutation replies, done frames and export documents. */
+    publicProjection(payload: Record<string, unknown>, profile: string | null): Promise<Record<string, unknown>>;
     private loadRevision;
     private readonly pageTails;
     private readonly pageContexts;
+    activitySummary(s: Session, turnId?: string): ReturnType<SessionPrefixIndex['activitySummary']>;
     private prefixIndex;
     /** Existing projections, once per complete turn range, in absolute transcript coordinates. */
     private deriveRange;
@@ -397,7 +411,7 @@ export declare class SessionService {
     /** A session without a sidecar, synthesized from state.db for this profile; 404/409 like the detail. */
     private foreignSession;
     /** Python `_handle_session_get` without a sidecar: the state.db transcript as a (read-only or claimable) foreign stub. */
-    foreignMessages(messages: Message[], session: object): Message[];
+    foreignMessages(messages: Message[], session: object, showReasoning?: boolean): Message[];
     private foreignSessionDetail;
     /** Clear persisted streaming flags when no live stream backs them (Python `_clear_stale_stream_state`). */
     clearStaleStreamState(session: Session): Promise<boolean>;
@@ -427,10 +441,17 @@ export declare class SessionService {
     status(sid: string): Promise<Record<string, unknown>>;
     contextDetail(sid: string, expectedKey: string): Promise<ContextDetail>;
     usage(sid: string): Promise<Record<string, unknown>>;
+    /** Only retained, readable identities in the request profile can become search pointers. */
+    private referenceSource;
+    referenceSearch(q: string, params: Parameters<SessionService['list']>[0]): Promise<Record<string, unknown>>;
+    /** A referenced creation has one durable identity, including after a lost HTTP response or server restart. */
+    createWithReferences(body: Record<string, unknown>, create: (sessionId?: string, validate?: () => Promise<void>) => Promise<Session>): Promise<Session>;
     resolveNewSessionWorkspace(body: Record<string, unknown>, visiblePrevSessionId: string | null, profile: string | null): Promise<string | null>;
     /** The server owns the names' normalization (TAL-631): trimmed, blanks dropped, and nothing left is the profile's defaults. */
     validateToolsetsShape(toolsets: unknown): string[] | null;
     create(body: Record<string, unknown>, opts?: {
+        sessionId?: string;
+        validateSources?: () => Promise<void>;
         worktree?: {
             path: string;
             branch: string;
@@ -612,6 +633,15 @@ export declare class SessionService {
         result: string;
         result_view: ToolResultView;
     }>;
+    /** Artifact state lives in the producer DB, never in a directive, saved scene or client-posted content. */
+    reviewOutboundDraft(input: OutboundDraftRef & {
+        session_id: string;
+        tool_call_id: string;
+    } & Partial<OutboundDraftAction>): Promise<{
+        draft: OutboundDraft | null;
+    }>;
+    private withShareLock;
+    private saveShareOwnership;
     createShare(sid: string): Promise<Record<string, unknown>>;
     revokeShare(sid: string): Promise<Record<string, unknown>>;
     loadShare(token: string): Promise<Record<string, unknown>>;