@adaptiqai/deepseek-harness 0.2.18 → 0.2.19

package/lib/types/host/knowledge-note.d.ts

@@ -0,0 +1,75 @@
+/**
+ * A turn is told which collections its conversation reads, once and again
+ * when they change. Nothing else in a turn says a collection is in use, so an
+ * agent asked about an id in one searched the person's files instead.
+ *
+ * The note is a sourced user message the agent loop logs with the turn's
+ * first step, as the harness's own context producers add theirs: the model
+ * reads it in every later request, and the conversation view shows it as
+ * context, not as the person's words.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ContextFormed, type UserMessage } from '@deepseek-ai/dsh-llm';
+import { type TurnNotes, type Workspace } from '@adaptiqai/core';
+/** Who produced the note, in the message's source. */
+export declare const NOTE_KIND = "adaptiq-knowledge";
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'adaptiq-knowledge': {
+            kind: 'adaptiq-knowledge';
+        } & ContextFormed;
+    }
+}
+/** One logged event of a session, as far as the note reads it. */
+interface LoggedEvent {
+    readonly type?: string;
+    readonly data?: {
+        readonly source?: {
+            readonly kind?: unknown;
+        };
+        readonly content?: readonly {
+            readonly type?: string;
+            readonly text?: unknown;
+        }[];
+    };
+}
+/** The agent proposing a step: its route and model, and its session's log. */
+interface NoteAgent {
+    readonly options: {
+        readonly provider?: string;
+        readonly model?: string;
+    };
+    readonly session: {
+        readonly id: string;
+        readonly seq?: number;
+        eventAt?(seq: number): LoggedEvent | undefined;
+    };
+}
+interface PreStep {
+    readonly agent: NoteAgent;
+    readonly step: number;
+    readonly signal: AbortSignal;
+}
+/**
+ * The last note a session's log holds, so a conversation resumed after a
+ * restart is not told twice.
+ * @param agent - the agent whose session it is.
+ * @returns the note's text, or null.
+ */
+export declare function loggedNote(agent: NoteAgent): string | null;
+/**
+ * The note for a step: on the first step of a turn on AdaptiqAI, when there is news.
+ * @param notes - the turn notes.
+ * @param route - the AdaptiqAI route.
+ * @param payload - the proposed step.
+ * @returns the note's message, or null.
+ */
+export declare function noteFor(notes: TurnNotes, route: string, payload: PreStep): Promise<UserMessage | null>;
+/**
+ * Tell each turn on AdaptiqAI which collections its conversation reads.
+ * @param ctx - a context with the `agents` service.
+ * @param workspace - the workspace.
+ * @param route - the AdaptiqAI route.
+ */
+export declare function registerKnowledgeNote(ctx: Context, workspace: Workspace, route: string): void;
+export {};

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

@@ -103,6 +103,7 @@ export declare function userTexts(messages: readonly RequestMessage[]): string[]
 /**
  * What the person wrote in the request history, each message marked when it
  * answers the agent's offer to save knowledge (the agent asked right before).
+ * The offer is recognised in core, the same in every harness.
  * @param messages - the request history.
  * @returns the person's turns, oldest first.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptiqai/deepseek-harness",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "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",
@@ -90,7 +90,7 @@
     "react-dom": "~18.3.1",
     "typescript": "~5.9.3",
     "vitest": "~3.2.7",
-    "@adaptiqai/core": "0.2.14"
+    "@adaptiqai/core": "0.2.15"
   },
   "repository": {
     "type": "git",