@adaptiqai/deepseek-harness 0.2.5 → 0.2.6

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

@@ -0,0 +1,10 @@
+import type { SessionView } from '@adaptiqai/core/types';
+import type { Kit } from './actions.ts';
+import { type T } from './ui.tsx';
+export declare function AttachPicker({ t, kit, view, modelName, disabled }: {
+    t: T;
+    kit: Kit;
+    view: SessionView;
+    modelName: string | null;
+    disabled: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,52 @@
+/** What the memory pill's "Add" list shows and the pill's "+ added" moment, kept apart from React so they can be tested. */
+import type { ConversationItem, KnowledgeItem, SessionView } from '@adaptiqai/core/types';
+type T = (key: string, params?: Record<string, unknown>) => string;
+/** One row of the pill's add list: a conversation or a collection, on or off. */
+export interface AttachRow {
+    readonly id: string;
+    readonly kind: 'conversation' | 'collection';
+    readonly name: string;
+    readonly updatedAt: number | null;
+    readonly tokens: number | null;
+    /** Attached to this conversation. */
+    readonly on: boolean;
+    /** Readiness of an attached item; a collection not ready yet cannot be added. */
+    readonly status: 'ready' | 'preparing' | 'failed' | 'not-ready';
+}
+/**
+ * The add list: recent conversations on this model (newest first, as the
+ * server pages them), then this model's collections; what is attached shows
+ * as on, with its readiness.
+ * @param view - the conversation.
+ * @param conversations - conversations on its model, or null while loading.
+ * @param collections - collections, or null while loading.
+ * @param query - search text.
+ * @returns the rows.
+ */
+export declare function attachRows(view: SessionView, conversations: readonly ConversationItem[] | null, collections: readonly KnowledgeItem[] | null, query: string): AttachRow[];
+/** How long the pill says what a mention just added. */
+export declare const ADDED_MS = 5000;
+/**
+ * The pill's words after a mention: what was added, and what stays text because it is on another model.
+ * @param t - translate.
+ * @param added - the conversation's "just added" mark.
+ * @returns e.g. "+ Novel A, Novel B".
+ */
+export declare function addedText(t: T, added: {
+    readonly names: readonly string[];
+    readonly otherModel: readonly string[];
+}): string;
+/**
+ * Follows a conversation's "just added" mark and reports a new one for
+ * {@link ADDED_MS}. A mark already there when the view first arrives is history.
+ */
+export declare class AddedFlash {
+    private readonly onChange;
+    private readonly ms;
+    private baseline;
+    private timer;
+    constructor(onChange: (added: NonNullable<SessionView['added']> | null) => void, ms?: number);
+    seen(added: SessionView['added'] | undefined): void;
+    dispose(): void;
+}
+export {};

package/lib/types/host/adapter.d.ts

@@ -7,6 +7,7 @@
 import { LlmAdapter, LlmError } from '@deepseek-ai/dsh-llm';
 import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, PreparedAdapterCall, ResolvedRetryPolicy, StreamChunk } from '@deepseek-ai/dsh-llm';
 import { type AdaptiqFailure, type AuthManager, type CatalogModel, type RequestEvents } from '@adaptiqai/core';
+import { type ReferencedSession } from './wire.ts';
 /** What the adapter tells the rest of the plugin about each request. */
 export interface AdapterDeps {
     readonly route: string;
@@ -26,7 +27,17 @@ export interface AdapterDeps {
     remember(sessionId: string | undefined): boolean;
     /** Whether the server already stores this conversation (may look it up first). */
     stored(sessionId: string | undefined): boolean | Promise<boolean>;
+    /**
+     * Attach the sessions a message mentioned with `@` to this conversation, when
+     * they are AdaptiqAI conversations on the same model.
+     * @returns session id → name of those attached and ready to read from memory.
+     */
+    recall?(sessionId: string, model: string, references: readonly ReferencedSession[], signal: AbortSignal): Promise<ReadonlyMap<string, string>>;
+    /** What the person wrote in this conversation (their own messages), for the tools' guards. */
+    noteUserTexts?(sessionId: string, texts: readonly string[]): void;
     readonly events: RequestEvents;
+    /** Diagnostics for one request (no content), when a debug log is on. */
+    debug?(message: string): void;
     readonly fetch?: typeof fetch;
 }
 /** The harness retries busy and preparing answers itself, honouring Retry-After. */

package/lib/types/host/wire.d.ts

@@ -3,7 +3,7 @@
  * (thinking field and values, sampling defaults) comes only from the
  * model's catalog entry.
  */
-import type { GenerateOptions } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, RequestMessage } from '@deepseek-ai/dsh-llm';
 import { type CatalogModel } from '@adaptiqai/core';
 /** One Chat Completions message. */
 export type WireMessage = {
@@ -38,13 +38,58 @@ export interface WireExtras {
     readonly stored?: boolean;
     /** Ask for streamed usage (always on for the adapter). */
     readonly includeUsage?: boolean;
+    /** Referenced sessions attached to this conversation and ready, by session id → name. */
+    readonly recalled?: ReadonlyMap<string, string>;
 }
+/** One session another message mentioned with `@`, as the harness snapshot records it. */
+export interface ReferencedSession {
+    readonly sessionId: string;
+    readonly label: string;
+}
+/**
+ * The sessions a harness `## Referenced sessions` snapshot carries, read from
+ * the message's structured source (`kind: 'session-reference'`), never its text.
+ * @param message - one request message.
+ * @returns the referenced sessions, or null when the message is not a snapshot.
+ */
+export declare function sessionReferences(message: RequestMessage): ReferencedSession[] | null;
+/**
+ * Every session the request's history mentions, first mention first.
+ * @param messages - the request history.
+ * @returns unique referenced sessions.
+ */
+export declare function referencedSessions(messages: readonly RequestMessage[]): ReferencedSession[];
+/**
+ * The line that stands in for transcripts the conversation now reads from memory.
+ * @param names - the attached conversations' names.
+ * @returns one short line for the model.
+ */
+export declare function recallLine(names: readonly string[]): string;
+/**
+ * A snapshot with the sessions read from memory taken out: one line names them,
+ * and the transcripts of any other referenced sessions stay as the harness wrote them.
+ * When the snapshot cannot be split safely it is kept whole.
+ * @param text - the snapshot text.
+ * @param references - the sessions it carries.
+ * @param recalled - session id → name of the sessions attached and ready.
+ * @returns the text to send.
+ */
+export declare function recallSnapshot(text: string, references: readonly ReferencedSession[], recalled: ReadonlyMap<string, string>): string;
+/**
+ * What the person wrote in the request history: their own messages (typed, or
+ * answered to a question of the model) only, not the harness's snapshots,
+ * runtime context or tool output.
+ * @param messages - the request history.
+ * @returns the text of each of the person's messages, oldest first.
+ */
+export declare function userTexts(messages: readonly RequestMessage[]): string[];
 /**
  * Convert the harness history to Chat Completions messages.
  * @param options - the harness request.
+ * @param recalled - referenced sessions read from memory: their snapshots become one line.
  * @returns the wire messages in order.
  */
-export declare function wireMessages(options: Pick<GenerateOptions, 'messages' | 'system'>): WireMessage[];
+export declare function wireMessages(options: Pick<GenerateOptions, 'messages' | 'system'>, recalled?: ReadonlyMap<string, string>): WireMessage[];
 /**
  * Build the request body for one call.
  * @param options - the harness request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptiqai/deepseek-harness",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "AdaptiqAI for DeepSeek Harness: models with 5M-token native memory and Knowledge. Sign up, get a model and work without leaving the harness",
   "keywords": [
     "dsh-plugin",
@@ -89,7 +89,7 @@
     "react-dom": "~18.3.1",
     "typescript": "~5.9.3",
     "vitest": "~3.2.7",
-    "@adaptiqai/core": "0.2.5"
+    "@adaptiqai/core": "0.2.6"
   },
   "repository": {
     "type": "git",