@markmo/europacore-session-ui 0.3.0 → 0.4.0

package/dist/api/agentClient.d.ts

@@ -1,7 +1,7 @@
 import type { BackgroundSubagent } from '../features/chat/model/subagents';
 import { type Transport } from '../host';
 import { type ConnectionState, type SseHandle } from './chatStream';
-import type { AcceptResult, AddedDir, AgentInfo, BackgroundTask, ContextUsage, CreateRun, CreateSession, Envelope, FleetRunSummary, FleetTaskDiff, McpServer, RunInspection, RunSummary, ModelInfo, Page, RedoResult, RestoreResult, ResumeRequest, Run, ServerInfo, Session, SessionPullRequest, SessionStatus, SnapshotInfo, TaskInfo, TranscriptItem, UndoRequest, UndoResult, WorkspaceDiff, WorkspaceInfo } from './wire';
+import type { AcceptResult, ClaimsView, ContextSources, MemoryPatch, MemoryRecord, MemoryRevision, MemoryStatusReport, ArtifactAccess, ArtifactInfo, ArtifactList, AddedDir, AgentInfo, BackgroundTask, ContextUsage, CreateRun, CreateSession, Envelope, FleetRunSummary, FleetTaskDiff, McpServer, RunInspection, RunSummary, ModelInfo, Page, RedoResult, RestoreResult, ResumeRequest, Run, ServerInfo, Session, SessionPullRequest, SessionStatus, SnapshotInfo, TaskInfo, TranscriptItem, UndoRequest, UndoResult, WorkspaceDiff, WorkspaceInfo } from './wire';
 export interface StreamHandlers {
     onEnvelope: (env: Envelope) => void;
     onState?: (state: ConnectionState, detail?: string) => void;
@@ -81,6 +81,67 @@ export declare class EuropacoreClient {
         server: string;
         tools: string[];
     }>;
+    /** The session's file claims, the other sessions in its repository with theirs, and requests to or from it. */
+    claims(id: string): Promise<ClaimsView>;
+    /**
+     * Let go of one of your own sessions' claims (every one without `paths`), or with `to` hand them to another
+     * session. What follows arrives as `claim.resolved` and in the sessions' `metadata.claims`.
+     */
+    releaseClaims(id: string, body: {
+        paths?: string[];
+        to?: string;
+        note?: string;
+    }): Promise<ClaimsView>;
+    /** Ask, on behalf of your own session, for paths another session holds; the request arrives as `claim.requested`. */
+    requestClaims(id: string, body: {
+        paths: string[];
+        reason?: string;
+    }): Promise<ClaimsView>;
+    /** The caller's long-term memories (one scope, or all of theirs), with their tokens and flags. */
+    memories(query?: {
+        scope?: string;
+        project?: string | null;
+        status?: string;
+        flag?: string;
+        q?: string;
+    }): Promise<MemoryRecord[]>;
+    /** One memory, with its markdown. */
+    memory(id: string): Promise<MemoryRecord>;
+    /** Change a memory's kind, description or body; with `revision`, 409 `memory_changed` if it moved on. */
+    updateMemory(id: string, patch: MemoryPatch): Promise<MemoryRecord>;
+    /** Forget (prune) a memory; restorable. Forgetting twice changes nothing, so it may be sent again. */
+    forgetMemory(id: string, reason: string): Promise<MemoryRecord>;
+    /** Bring a forgotten or merged memory back. */
+    restoreMemory(id: string): Promise<MemoryRecord>;
+    /** A memory's revisions, newest first. */
+    memoryRevisions(id: string): Promise<MemoryRevision[]>;
+    /** Each of the caller's memory scopes at a glance, and their projects with memories. */
+    memoryStatus(project?: string | null): Promise<MemoryStatusReport>;
+    /** What a session loads, source by source in load order. */
+    contextSources(id: string): Promise<ContextSources>;
+    /** The caller's artifacts, newest first; with `session`, that session's first, and with `shared` others' shared with them. */
+    artifactList(session?: string | null, options?: {
+        shared?: boolean;
+    }): Promise<ArtifactList>;
+    /** One artifact: the caller's, or with `owner` one that user shares with the caller. Its `url` opens now. */
+    artifact(id: string, owner?: string | null): Promise<ArtifactInfo>;
+    /** Who can open one of the caller's artifacts. Narrowing it stops the links already given out. */
+    setArtifactAccess(id: string, access: ArtifactAccess): Promise<ArtifactInfo>;
+    /** Stop every link to one of the caller's artifacts; who can open it stays the same, through new links. */
+    revokeArtifactLinks(id: string): Promise<ArtifactInfo>;
+    /** Delete an artifact and every version; with `unpublish`, its published copy is taken down first, and nothing is deleted when that fails. */
+    deleteArtifact(id: string, options?: {
+        unpublish?: boolean;
+    }): Promise<void>;
+    /** Take one of the caller's artifacts' published copy down (a permanent one: a temporary one only expires). Slow. */
+    unpublishArtifact(id: string): Promise<ArtifactInfo>;
+    /**
+     * A viewer link the server gave, made absolute. A server that knows its public URL (europacoreui's does) gives
+     * absolute links; one that does not gives paths from its root, put after the transport's base without its `/v1`.
+     */
+    artifactLink(url: string): string;
+    /** One file of a version, through the viewer. The link is the capability: no credentials are sent with it. */
+    artifactFile(link: string, path: string, version: number): Promise<Uint8Array>;
     /** The session's workspace: branch and the files changed since `base` (HEAD by default). */
     sessionWorkspace(sessionId: string, base?: string): Promise<WorkspaceInfo>;
     /** A unified diff of the session's workspace; one file when `path` (repository-relative) is given. */

package/dist/api/wire.d.ts

@@ -35,6 +35,19 @@ export interface ServerInfo {
             accept: boolean;
             max_bytes: number;
         };
+        /** The server keeps artifacts, the pages agents make (`/v1/artifacts` and its viewer). */
+        artifacts?: boolean;
+        /** It can take an artifact's permanent published copy down (`POST /v1/artifacts/{id}/unpublish`). */
+        artifact_unpublish?: boolean;
+        /** The server keeps long-term memories (`/v1/memories`, `europacore serve --memory`). */
+        memory?: boolean;
+        /** Sessions list what they load, source by source (`GET /v1/sessions/{sid}/context/sources`). */
+        context_sources?: boolean;
+        /**
+         * It keeps file claims per repository: a session's write to a file another session owns is refused and the
+         * owner's agent is asked for it (`/v1/sessions/{sid}/claims`, spec §3.14). Its sessions' agents message each other.
+         */
+        peers?: boolean;
     };
     principal: {
         workspace_id: string | null;
@@ -79,6 +92,8 @@ export interface AgentInfo {
         permission_modes?: boolean;
         /** An `exit_plan_mode` approval may carry an edited plan (`Resume.plan`). */
         plan_edits?: boolean;
+        /** Its sessions take part in file claims and peer messages (`message_session`, `answer_claim_request`). */
+        peers?: boolean;
     };
     /** The permission modes its sessions may use (Claude Code's: default, acceptEdits, plan, …); empty for none. */
     permission_modes?: string[];
@@ -175,10 +190,13 @@ export interface WorkspaceInfo {
     files: ChangedFile[];
     files_truncated: boolean;
 }
-/** A command or sub-agent running in the background of a session (`tasks.updated`, `/v1/sessions/{sid}/tasks`). */
+/**
+ * A command, sub-agent or monitor running in the background of a session (`tasks.updated`,
+ * `/v1/sessions/{sid}/tasks`). A monitor is a command or file watch whose output wakes the agent.
+ */
 export interface BackgroundTask {
     task_id: string;
-    kind: 'command' | 'subagent';
+    kind: 'command' | 'subagent' | 'monitor';
     title: string;
     state: 'running' | 'completed' | 'failed' | 'stopped';
     /** Running time so far, or in all once finished. */
@@ -190,6 +208,8 @@ export interface BackgroundTask {
     /** The start of a sub-agent's result. */
     summary?: string;
     error?: string;
+    /** A monitor's batches of output so far. */
+    events?: number;
     /** A sub-agent's agent, when the server says (not in the contract yet; the row shows it before the title). */
     agent?: string;
 }
@@ -286,6 +306,237 @@ export interface FleetReviewEntry {
     max_rounds: number;
     attention: 'ready_to_merge' | 'ci_failed' | null;
 }
+export type MemoryScopeName = 'org' | 'user' | 'project';
+export type MemoryRecordKind = 'user' | 'feedback' | 'project' | 'reference';
+export type MemoryRecordStatus = 'active' | 'merged' | 'pruned';
+export type MemoryFlagName = 'stale' | 'duplicate' | 'over_cap' | 'never_recalled' | 'kept';
+export interface MemoryScopeKey {
+    scope: MemoryScopeName;
+    workspace_id: string | null;
+    user_id: string | null;
+    project_id: string | null;
+}
+/** Something to know about a memory; a duplicate names its partner. */
+export interface MemoryFlag {
+    flag: MemoryFlagName;
+    detail: string;
+    partner_id?: string | null;
+    partner_name?: string | null;
+}
+/** One memory. `tokens` and `flags` come from servers that compute them (absent on older ones). */
+export interface MemoryRecord {
+    id: string;
+    key: MemoryScopeKey;
+    kind: MemoryRecordKind;
+    name: string;
+    description: string;
+    body: string;
+    status: MemoryRecordStatus;
+    superseded_by: string | null;
+    source: string;
+    session_id: string | null;
+    revision: number;
+    created_at: string;
+    updated_at: string;
+    last_recalled_at: string | null;
+    recall_count: number;
+    kept_until: string | null;
+    metadata: Record<string, unknown>;
+    tokens?: {
+        index: number;
+        body: number;
+    };
+    flags?: MemoryFlag[];
+    /** `GET /v1/memories/{id}` only: the memory in Claude Code's auto-memory format. */
+    markdown?: string;
+}
+export interface MemoryPatch {
+    kind?: MemoryRecordKind;
+    description?: string;
+    body?: string;
+    /** The revision the change was made against: 409 `memory_changed` when it has moved on. */
+    revision?: number;
+}
+export interface MemoryRevision {
+    id: string;
+    memory_id: string;
+    revision: number;
+    op: string;
+    before: Record<string, unknown> | null;
+    after: Record<string, unknown> | null;
+    actor: string;
+    dream_id: string | null;
+    session_id: string | null;
+    created_at: string;
+}
+export interface MemoryScopeStatus {
+    scope: MemoryScopeName;
+    label: string;
+    project_id?: string | null;
+    active_by_kind: Record<string, number>;
+    index_lines: number;
+    index_chars: number;
+    index_tokens?: number;
+    retired?: number;
+    flags?: Partial<Record<MemoryFlagName, number>>;
+    last_dream: string | null;
+    sessions_since_dream: number;
+    changes_since_dream: number;
+}
+export interface MemoryStatusReport {
+    scopes: MemoryScopeStatus[];
+    /** The caller's own projects with memories. */
+    projects?: string[];
+}
+export type ContextSourceKind = 'system_prompt' | 'tools' | 'instructions' | 'environment' | 'memory_index' | 'memory_preload' | 'skill' | 'plan' | 'hook' | 'other' | 'conversation';
+/** One thing a session's model reads, in load order. */
+export interface ContextSource {
+    n: number;
+    id: string;
+    kind: ContextSourceKind;
+    label: string;
+    origin?: string | null;
+    path?: string | null;
+    scope?: string | null;
+    retention?: string | null;
+    /** sent: the model has it; pending: it reaches the next call; preview: a memory index not pinned yet. */
+    status: 'sent' | 'pending' | 'preview';
+    tokens: number;
+    chars: number;
+    items: number;
+    text?: string | null;
+}
+export interface ContextSources {
+    session_id: string | null;
+    model: string | null;
+    context_window: number | null;
+    estimated_tokens: number;
+    sources: ContextSource[];
+    memory?: {
+        scopes: {
+            scope: MemoryScopeName;
+            label: string;
+            workspace_id: string | null;
+            user_id: string | null;
+            project_id: string | null;
+        }[];
+        writable: boolean;
+        preload_k: number;
+        index_max_lines: number;
+        index_max_chars: number;
+    } | null;
+}
+/**
+ * Who can open an artifact: its owner (`private`, with links that expire), everyone signed in to its workspace
+ * (`workspace`, likewise), or anyone with its link (`public`).
+ */
+export type ArtifactAccess = 'private' | 'workspace' | 'public';
+/** Where a version was put for anyone with the link; a temporary page has a claim link and an expiry. */
+export interface ArtifactPublication {
+    target: string;
+    url: string;
+    claim_url: string | null;
+    expires_at: string | null;
+    created_at?: string | null;
+    /** The session that published it, from servers that keep it. */
+    session_id?: string | null;
+    /** When it was taken down; a copy taken down is no longer up. */
+    removed_at?: string | null;
+}
+/** What the runs that wrote a version spent: each run's tokens since its previous write, other work included. */
+export interface ArtifactUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    total_tokens: number;
+    cost_usd?: number | null;
+}
+export interface ArtifactVersionInfo {
+    version: number;
+    created_at: string;
+    /** The version's file paths, the entry among them. */
+    files: string[];
+    published: ArtifactPublication | null;
+    /** The session whose run wrote this version, from servers that keep it; null when unknown. */
+    session_id?: string | null;
+    /** From servers that measure them (absent on older ones). */
+    bytes?: number;
+    usage?: ArtifactUsage | null;
+    /** The git repository the writing session's workspace was in (`owner/repo`); null outside one. */
+    project?: string | null;
+}
+/** Opens of an artifact's page. `people` are others who opened it signed in; `link` the opens of its public link. */
+export interface ArtifactViews {
+    total: number;
+    last_30_days: {
+        opens: number;
+        link: number;
+        own: number;
+        people: number;
+    };
+    /** The latest open by anyone else, or through the public link. */
+    last_viewed_at: string | null;
+}
+/** An artifact as `/v1/artifacts` shows it. `url` is the viewer's: absolute, or server-relative. */
+export interface ArtifactInfo {
+    id: string;
+    title: string;
+    description: string;
+    icon: string | null;
+    format: 'html' | 'markdown' | string;
+    entry: string;
+    version: number;
+    versions: ArtifactVersionInfo[];
+    /** The session that made it; null for one no session made. */
+    session_id: string | null;
+    url: string;
+    published_url: string | null;
+    created_at: string;
+    updated_at: string;
+    /** The latest version's bytes, from servers that measure them. */
+    size?: number | null;
+    /** Summed over the versions that carry usage; `versions` says how many did. */
+    usage?: (ArtifactUsage & {
+        versions: number;
+    }) | null;
+    /** Its versions' repositories, in the order first written; from servers that record them. */
+    projects?: string[];
+    /** Who can open it; absent from servers that keep no access (there, anyone with the link can). */
+    access?: ArtifactAccess;
+    /** When it was first shared beyond its owner; null while private, and for one public from before access. */
+    shared_at?: string | null;
+    /** The owner's user id. */
+    owner?: string | null;
+    /** The caller owns it: false for one shared with the caller. */
+    mine?: boolean;
+    /** When `url` stops opening: a signed link's expiry; null for the public link. */
+    url_expires_at?: string | null;
+    /** How often its page was opened; the owner's only, from servers that count. */
+    views?: ArtifactViews | null;
+}
+/** `GET /v1/artifacts`: the list, and the repository of the session named by `session=`. */
+export interface ArtifactList {
+    artifacts: ArtifactInfo[];
+    project?: string | null;
+    /** Others' artifacts shared with the caller, when asked for (`shared=true`). */
+    shared?: ArtifactInfo[];
+}
+/** A page a session wrote (`artifact_write`), as the server keeps it in `metadata.artifacts`, the newest write last. */
+export interface SessionArtifact {
+    id: string;
+    title: string;
+    version: number;
+    format: string;
+    /** The viewer's url; it carries a token, so it is never shown. */
+    url: string | null;
+    published_url?: string | null;
+    claim_url?: string | null;
+    expires_at?: string | null;
+    target?: string | null;
+    since?: string | null;
+    access?: ArtifactAccess;
+}
 /** A pull request a session opened (or registered), and where its CI and review have got to (`metadata.pull_requests`). */
 export interface SessionPullRequest {
     number: number;
@@ -309,6 +560,144 @@ export interface SessionPullRequest {
     since?: string;
     head_sha?: string;
 }
+/** A session as another session sees it, in a repository's claims: never its transcript. */
+export interface Ref {
+    session_id: string;
+    title: string;
+    user: string;
+    /** One of the caller's own sessions (a teammate's is not). */
+    mine: boolean;
+    /** A session handed off to the cloud, mirrored here. */
+    cloud?: boolean;
+}
+/**
+ * A claim on a path of a repository (`'dir/'` covers what is under it). A `change` claim is the first writer's
+ * while the path has uncommitted changes in that checkout; a `declared` one was claimed or given and holds anywhere
+ * in the repository; a `shared` one has two holders and a boundary between them.
+ */
+export interface Claim {
+    path: string;
+    kind: 'change' | 'declared' | 'shared';
+    holders: Ref[];
+    checkout: string;
+    /** What each holder keeps to, for a shared claim (a `keep` records one too); advisory inside the file. */
+    boundary?: string | null;
+    reason: string;
+    since: string;
+    /** Sessions the path passes to, first come first served, once its holder is done with it. */
+    queue: Ref[];
+}
+/** What the owner does with one path a contender asks for. */
+export type Disposition = 'give' | 'keep' | 'share' | 'after' | 'will_do';
+export type ClaimOutcome = 'handed_over' | 'declined' | 'split' | 'share' | 'after' | 'will_do' | 'released' | 'committed' | 'withdrawn' | 'deleted' | 'user' | 'cycle' | 'expired';
+/**
+ * A contender's request for paths another session owns: the owner answers per path (round 1), the contender may
+ * counter once (round 2), and the owner's reply is final (round 3).
+ */
+export interface ClaimRequest {
+    id: string;
+    paths: string[];
+    contender: Ref;
+    owner: Ref;
+    /** The kind of claim the owner held when the request opened. */
+    owner_kind: Claim['kind'];
+    /** The contender's task, or the reason it gave. */
+    reason: string;
+    /** The refused edit, as a short diff; empty when no write was refused. */
+    change: string;
+    /** How often the owner has written each path. */
+    owner_writes: Record<string, number>;
+    round: 1 | 2 | 3;
+    status: 'open' | 'answered' | 'countered' | 'doing' | 'ended';
+    answer?: Record<string, Disposition> | null;
+    counter?: Record<string, Disposition> | null;
+    boundary?: string | null;
+    note?: string | null;
+    /** Paths the owner has made the contender's change to (a `will_do`). */
+    done?: string[] | null;
+    outcome?: ClaimOutcome | null;
+    since: string;
+}
+/** What a peer message is about: free text (`message_session`), a request and its rounds, or a path come free. */
+export type PeerAbout = 'message' | 'request' | 'answer' | 'counter' | 'done' | 'free' | 'cycle';
+/** A message to a session's agent from another session's (`from`), or from the claims themselves (null). */
+export interface PeerMessage {
+    id: string;
+    from: Ref | null;
+    to: Ref;
+    about: PeerAbout;
+    request_id?: string | null;
+    text: string;
+    at: string;
+}
+/** How a peer message reached its session: drained into a live run, woke it with a notice run, or waits. */
+export type PeerDelivery = 'live' | 'woke' | 'waiting';
+/** `peer.message`, on the recipient's stream. */
+export type PeerMessageEvent = PeerMessage & {
+    delivery?: PeerDelivery;
+};
+/** Another session working in the same repository, with what it holds. */
+export interface PeerSession {
+    session_id: string;
+    title: string;
+    user: string;
+    /** The user owns that session too (not a teammate's). */
+    mine?: boolean;
+    /** A session handed off to the cloud, mirrored here. */
+    cloud?: boolean;
+    checkout: string;
+    running: boolean;
+    claims: Claim[];
+}
+/** `GET /v1/sessions/{sid}/claims`: the session's claims, the other sessions here, and requests to or from it. */
+export interface ClaimsView {
+    repo: string;
+    checkout: string;
+    claims: Claim[];
+    others: PeerSession[];
+    requests: ClaimRequest[];
+    /** Messages waiting for the session's next run. */
+    pending: PeerMessage[];
+    /** 'contested': a request it made could not be settled between the agents, so it needs its user. */
+    attention: string | null;
+    /** Why it needs its user, in the server's words. */
+    attention_reason?: string | null;
+}
+/** `metadata.claims`, which the server owns and writes before it tells the model. */
+export interface MetadataClaims {
+    v: 1;
+    repo: string;
+    checkout: string;
+    /** The paths it has changed and so owns until they are committed. */
+    changed: unknown[];
+    /** The paths it claimed, or was given. */
+    declared: unknown[];
+    /** Its requests, live or settled in the last hour; their `owner` and `contender` are session ids here. */
+    requests: unknown[];
+    pending: PeerMessage[];
+    attention: string | null;
+    attention_reason?: string | null;
+}
+/** `display.kind == 'peer_message'`: what `message_session` sent, and how it was delivered. */
+export interface PeerMessageDisplay {
+    kind: 'peer_message';
+    to: Ref | string;
+    text: string;
+    delivery?: PeerDelivery | null;
+}
+/** `display.kind == 'claim_answer'`: what `answer_claim_request` answered, in which round. */
+export interface ClaimAnswerDisplay {
+    kind: 'claim_answer';
+    request_id: string;
+    round: number;
+    answer?: Record<string, Disposition> | null;
+    /** It accepted the answer (the asker) or the counter (the owner). */
+    accept?: boolean;
+    /** Paths whose promised change it reported made. */
+    done?: string[];
+    boundary?: string | null;
+    note?: string | null;
+}
 /** A fleet run as `GET /v1/fleet/runs` lists it. */
 export interface FleetRunSummary {
     run_id: string;
@@ -436,13 +825,50 @@ export type TranscriptItem = {
     id: string;
     summary?: string;
 }
-/** Put in the history by the harness, not the user: what woke the agent (`task_notice`), a hook's or a recovery's. */
+/**
+ * Put in the history by the harness, not the user: what woke the agent (`task_notice`), a hook's or a recovery's,
+ * or a monitor's output (`monitor`, with its fields).
+ */
  | {
     kind: 'notice';
     id: string;
     origin?: string;
     text: string;
+    monitor?: MonitorOutput;
+}
+/** A message from another session's agent, as the agent read it (a peer, not the user). */
+ | {
+    kind: 'peer';
+    id: string;
+    from?: Ref | null;
+    about?: PeerAbout;
+    request_id?: string | null;
+    text: string;
+    at?: string;
 };
+/** How a monitor ended: its command exited, it reached its timeout, it printed too much, or it was stopped. */
+export interface MonitorEnd {
+    reason: 'exited' | 'timeout' | 'rate' | 'user' | 'stopped';
+    exit_code?: number | null;
+    seconds?: number | null;
+    /** Its batches of output in all. */
+    events?: number;
+    /** The last line of a failed command's stderr. */
+    stderr?: string;
+}
+/**
+ * What the agent was given of a monitor's output (`monitor_output`, and a `monitor` notice in `/messages`): its new
+ * lines (a command's stdout, or `added|modified|deleted <path>` for a file watch), and how it ended.
+ */
+export interface MonitorOutput {
+    monitor_id: string;
+    description: string;
+    kind: 'command' | 'files';
+    lines: string[];
+    /** Lines that arrived but were not passed on. */
+    dropped: number;
+    end: MonitorEnd | null;
+}
 /** `notice`: a run the server started itself, because a background task finished while the session was idle. */
 export type RunKind = 'turn' | 'resume' | 'notice';
 export type RunStatus = 'queued' | 'running' | 'completed' | 'paused' | 'failed' | 'cancelled';
@@ -650,14 +1076,45 @@ export interface AnswersDisplay {
         answer: string;
     }[];
 }
+/**
+ * `display.kind == "artifact"`: a page `artifact_write` made or `artifact_publish` put up (spec §5.2). `url` is the
+ * viewer's, null when the server has none; a publish adds where it went.
+ */
+export interface ArtifactDisplay {
+    kind: 'artifact';
+    id: string;
+    title: string;
+    version: number;
+    format: string;
+    url: string | null;
+    published_url?: string | null;
+    claim_url?: string | null;
+    expires_at?: string | null;
+    target?: string | null;
+    /** Who can open it, from servers that keep access. */
+    access?: ArtifactAccess;
+    /** `artifact_unpublish`: the published copy's address, now taken down. */
+    removed_url?: string | null;
+}
+/** `display.kind == "artifact_deleted"`: the agent's `artifact_delete` removed a page, and the sessions that wrote it. */
+export interface ArtifactDeletedDisplay {
+    kind: 'artifact_deleted';
+    id: string;
+    title: string;
+    sessions?: string[];
+}
 export type ToolDisplay = {
     kind: 'plan';
     plan: PlanItem[];
     summary?: string;
-} | DiffDisplay | ExecDisplay | AnswersDisplay | {
+} | DiffDisplay | ExecDisplay | AnswersDisplay | ArtifactDisplay | ArtifactDeletedDisplay | PeerMessageDisplay | ClaimAnswerDisplay | {
     kind: string;
     [key: string]: unknown;
 };
+export declare function isPeerMessageDisplay(display: ToolDisplay | null | undefined): display is PeerMessageDisplay;
+export declare function isClaimAnswerDisplay(display: ToolDisplay | null | undefined): display is ClaimAnswerDisplay;
+export declare function isArtifactDisplay(display: ToolDisplay | null | undefined): display is ArtifactDisplay;
+export declare function isArtifactDeletedDisplay(display: ToolDisplay | null | undefined): display is ArtifactDeletedDisplay;
 export declare function isDiffDisplay(display: ToolDisplay | null | undefined): display is DiffDisplay;
 export declare function isExecDisplay(display: ToolDisplay | null | undefined): display is ExecDisplay;
 export declare function isAnswersDisplay(display: ToolDisplay | null | undefined): display is AnswersDisplay;

package/dist/features/artifacts/ArtifactDetail.d.ts

@@ -0,0 +1,15 @@
+import type { ArtifactInfo } from '../../api/wire';
+import { type SessionLink } from '../chat/model/artifacts';
+export type DetailAction = 'access' | 'delete' | 'unpublish';
+export declare function ArtifactDetail({ artifact: a, link, canUnpublish, mentionIn, onAction, sessionTitle, }: {
+    artifact: ArtifactInfo;
+    link: (id: string | null) => SessionLink;
+    canUnpublish: boolean;
+    /** The session `@artifact:<id>` goes into, when the page was opened from one. */
+    mentionIn: {
+        title: string;
+        mention: (text: string) => void;
+    } | null;
+    onAction: (action: DetailAction) => void;
+    sessionTitle: (id: string | null) => string | null;
+}): import("react").JSX.Element;

package/dist/features/artifacts/ArtifactDialogs.d.ts

@@ -0,0 +1,29 @@
+import type { ArtifactInfo } from '../../api/wire';
+import { type ExportScope } from '../chat/model/artifactExport';
+import { type SessionLink } from '../chat/model/artifacts';
+export declare function DeleteArtifactsDialog({ items, link, canUnpublish, onClose, onDone, onMakePrivate, onExport, }: {
+    items: ArtifactInfo[];
+    link: (id: string | null) => SessionLink;
+    canUnpublish: boolean;
+    onClose: () => void;
+    onDone: () => void;
+    /** Make them private instead (`p`). */
+    onMakePrivate: () => void;
+    /** Save a copy first (`s`; a download here, europacorecli's workspace archive). */
+    onExport: () => Promise<void>;
+}): import("react").JSX.Element;
+export declare function AccessDialog({ items, onClose }: {
+    items: ArtifactInfo[];
+    onClose: () => void;
+}): import("react").JSX.Element;
+/** Take a permanent published copy down (`U`), after saying what that does. */
+export declare function UnpublishDialog({ artifact, onClose }: {
+    artifact: ArtifactInfo;
+    onClose: () => void;
+}): import("react").JSX.Element;
+/** The export menu (`X`): CSV of the rows, a ZIP of the files, the page to print, and the source as written. */
+export declare function ExportMenu({ scope, sessionTitle, label, }: {
+    scope: ExportScope;
+    sessionTitle: (id: string | null) => string | null;
+    label?: string;
+}): import("react").JSX.Element;

package/dist/features/artifacts/ArtifactLedger.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactInfo } from '../../api/wire';
+import { type SortColumn } from '../chat/model/artifacts';
+export declare function ArtifactLedger({ rows, sessionTitle, initialSort, initialDescending, onOpen, onDelete, onAccess, }: {
+    rows: ArtifactInfo[];
+    sessionTitle: (id: string | null) => string | null;
+    initialSort?: SortColumn;
+    initialDescending?: boolean;
+    onOpen: (a: ArtifactInfo) => void;
+    onDelete: (items: ArtifactInfo[]) => void;
+    onAccess: (items: ArtifactInfo[]) => void;
+}): import("react").JSX.Element;

package/dist/features/artifacts/ArtifactStats.d.ts

@@ -0,0 +1,9 @@
+import type { ArtifactInfo } from '../../api/wire';
+export declare function ArtifactStats({ list, project, onOpen, onLedger, }: {
+    list: ArtifactInfo[];
+    /** The repository of the session the page was opened from, for `p`. */
+    project: string | null;
+    onOpen: (a: ArtifactInfo) => void;
+    /** Open the ledger on these, oldest first (untouched) or as they come (stale). */
+    onLedger: (only: 'untouched' | 'stale') => void;
+}): import("react").JSX.Element;

package/dist/features/artifacts/ArtifactsPage.d.ts

@@ -0,0 +1 @@
+export default function ArtifactsPage(): import("react").JSX.Element;