@adaptiqai/deepseek-harness 0.2.6 → 0.2.12

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

@@ -47,6 +47,8 @@ export interface AdaptiqRemote {
     refresh(): Promise<RemoteResult<AccountSnapshot>>;
     setPreferences(patch: Partial<Preferences>): Promise<RemoteResult<Preferences>>;
     dismissNotice(id: string): Promise<RemoteResult<void>>;
+    updatePlugin(): Promise<RemoteResult<void>>;
+    activateUpdate(): Promise<RemoteResult<void>>;
     getSession(sessionId: string): Promise<RemoteResult<SessionView>>;
     watchSession(sessionId: string, signal?: AbortSignal): AsyncIterable<SessionView> & {
         dispose(): void;

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

@@ -6,8 +6,8 @@
  */
 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';
+import { type AdaptiqFailure, type AuthManager, type CatalogModel, type RequestEvents, type UserTurn } from '@adaptiqai/core';
+import { type ParentSession, type ReferencedSession } from './wire.ts';
 /** What the adapter tells the rest of the plugin about each request. */
 export interface AdapterDeps {
     readonly route: string;
@@ -33,13 +33,27 @@ export interface AdapterDeps {
      * @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;
+    /** Attach what was added to the conversation before this, its first, message. */
+    attachPending?(sessionId: string): Promise<void>;
+    /** What the person wrote in this conversation (their own messages, marked when they answer an offer to save knowledge), for the tools' guards. */
+    noteUserTexts?(sessionId: string, texts: readonly UserTurn[]): void;
+    /** The session that started this one (a subagent's or teammate's parent), if any. */
+    parentSession?(sessionId: string): ParentSession | undefined;
     readonly events: RequestEvents;
+    /** Whether the server behind a model puts idle conversations to sleep (it reports session history apart). */
+    readonly autoSleep?: (model: string) => boolean;
     /** Diagnostics for one request (no content), when a debug log is on. */
     debug?(message: string): void;
     readonly fetch?: typeof fetch;
 }
+/** How long a first message waits for what was added before it to attach. */
+export declare const ATTACH_WAIT_MS = 10000;
+/**
+ * How often a conversation is told that it needs no compacting. The harness asks
+ * again at every step once its history passes its pressure threshold; the
+ * answer is the same each time and one toast says it.
+ */
+export declare const COMPACTION_NOTICE_MS: number;
 /** The harness retries busy and preparing answers itself, honouring Retry-After. */
 export declare const RETRY_POLICY: ResolvedRetryPolicy;
 /**
@@ -53,8 +67,11 @@ export declare function resolvedInfo(route: string, model: CatalogModel): LlmRes
 export declare function toLlmError(failure: AdaptiqFailure, cause?: unknown): LlmError;
 export declare class AdaptiqAdapter extends LlmAdapter {
     private readonly deps;
+    private readonly now;
     private readonly fetch;
-    constructor(deps: AdapterDeps);
+    /** When each conversation was last told that nothing needs compacting. */
+    private readonly compactionTold;
+    constructor(deps: AdapterDeps, now?: () => number);
     providerInfo(provider: string): LlmProviderInfo;
     providerRetryPolicy(): ResolvedRetryPolicy;
     listModels(provider: string): Promise<readonly LlmModelInfo[]>;

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

@@ -1,6 +1,9 @@
 /** `/adaptiq`: status, sign-in, privacy and knowledge from the composer, in plain text. */
 import type { Context } from '@deepseek-ai/cordis';
 import { type AuthManager, type Workspace } from '@adaptiqai/core';
+export declare const HELP: string;
+/** The actions the composer offers after `/adaptiq`: every one HELP lists. */
+export declare const HINT = "status \u00B7 signin \u00B7 private \u00B7 remember \u00B7 knowledge \u00B7 open \u00B7 diagnostics \u00B7 signout";
 /**
  * The action word of `/adaptiq …`, however the composer passes it: with or
  * without the command name, a leading slash, or a completion glued on with "/".

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

@@ -30,6 +30,8 @@ export declare class AdaptiqController extends TypertRemoteService {
     private readonly deps;
     static inject: string[];
     constructor(ctx: Context, deps: ControllerDeps);
+    /** A stream ends when its caller leaves or this plugin code is replaced (an update loaded in place). */
+    private until;
     /** Read the current account snapshot. */
     getState(): Promise<AccountSnapshot>;
     /** Follow the account snapshot: the current one, then every change. */
@@ -46,6 +48,10 @@ export declare class AdaptiqController extends TypertRemoteService {
     setPreferences(patch: Partial<Preferences>): Promise<Preferences>;
     /** Take one notice down. */
     dismissNotice(id: string): Promise<void>;
+    /** Install the newest published version through the harness and load it, without a restart where the harness allows. */
+    updatePlugin(): Promise<void>;
+    /** Switch to the newer version already installed on disk. */
+    activateUpdate(): Promise<void>;
     /** Read one conversation's memory and knowledge. */
     getSession(sessionIdValue: string): Promise<SessionView>;
     /** Follow one conversation's memory and request state. */

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

@@ -0,0 +1,29 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { Config } from './config.ts';
+import type { HostRuntime } from './updater.ts';
+export { Config };
+export declare const name = "adaptiq";
+export declare const inject: string[];
+export declare const usage = "\nAdaptiqAI models with native memory, signed in with your AdaptiqAI account.\nOpen **Settings \u2192 AdaptiqAI** to connect, or run `/adaptiq signin`.\n";
+/** What this loader offers the code it loads; bumped when that changes. */
+export declare const ENTRY_PROTOCOL = 1;
+/** What lib/host.js exports. */
+export interface HostModule {
+    applyWith(ctx: Context, config: Config, runtime: HostRuntime | undefined): Promise<void>;
+    /** Remote methods, composition and configuration schema: equal means the new code can replace the old in place. */
+    readonly RELOAD_SIGNATURE: string;
+    readonly ENTRY_PROTOCOL: number;
+    readonly VERSION: string;
+}
+/** Where the Host half and the package manifest live, beside this file. */
+export interface HostFiles {
+    readonly host: URL;
+    readonly manifest: URL;
+}
+/**
+ * Mount the plugin through the swappable Host half.
+ * @param ctx - the plugin context.
+ * @param config - resolved configuration.
+ * @param files - where the code lives (tests point elsewhere).
+ */
+export declare function apply(ctx: Context, config: Config, files?: HostFiles): Promise<void>;

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

@@ -1,12 +1,26 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './config.ts';
+import { type HostRuntime } from './updater.ts';
 export { Config };
 export declare const name = "adaptiq";
 export declare const inject: string[];
 export declare const usage = "\nAdaptiqAI models with native memory, signed in with your AdaptiqAI account.\nOpen **Settings \u2192 AdaptiqAI** to connect, or run `/adaptiq signin`.\n";
+/** The loader protocol this code expects (entry.ts ENTRY_PROTOCOL). */
+export declare const ENTRY_PROTOCOL = 1;
+/** Remote methods, composition and configuration schema, fixed at build time. */
+export declare const RELOAD_SIGNATURE: string;
+/** The version of this code. */
+export declare const VERSION: string;
 /**
- * Mount the plugin.
+ * Mount the plugin, loaded directly.
  * @param ctx - the plugin context.
  * @param config - resolved configuration.
  */
 export declare function apply(ctx: Context, config: Config): Promise<void>;
+/**
+ * Mount the plugin.
+ * @param ctx - the plugin context.
+ * @param raw - configuration, resolved again with this version's own defaults.
+ * @param runtime - the loader's update hooks, when lib/index.js loaded this code.
+ */
+export declare function applyWith(ctx: Context, raw: Config, runtime: HostRuntime | undefined): Promise<void>;

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

@@ -0,0 +1,23 @@
+/**
+ * Where a live harness session came from: its subagents are helpers of the
+ * session that started them, its Agent Team's teammates are tracks. Read from
+ * the harness's own services, all optional.
+ */
+import { type ParentSession, type SessionOrigin } from './wire.ts';
+/** A live harness Agent, as `agents` returns it. */
+export interface AgentLike {
+    readonly session?: {
+        readonly header?: SessionOrigin;
+    };
+}
+/** The harness context, as far as this reads it. */
+export interface ServicesLike {
+    get(name: string): unknown;
+}
+/**
+ * The session that started a live harness session.
+ * @param ctx - the plugin context.
+ * @param sessionId - harness session id.
+ * @returns the parent and role, or undefined for a root session or one not loaded.
+ */
+export declare function sessionParent(ctx: ServicesLike, sessionId: string): ParentSession | undefined;

package/lib/types/host/release-age.d.ts

@@ -0,0 +1,57 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Where the entries of `minimumReleaseAgeExclude` sit in the file's lines. */
+interface ExcludeList {
+    readonly lines: readonly string[];
+    /** The key's line, or -1 when the key is absent. */
+    readonly keyLine: number;
+    /** The key line rewritten for a block list, when it held an empty flow list (`[]`). */
+    readonly blockKey: string | null;
+    /** Line index and value of each entry. */
+    readonly entries: readonly {
+        readonly line: number;
+        readonly value: string;
+    }[];
+    readonly indent: string;
+}
+/**
+ * Read the exclusion list out of pnpm-workspace.yaml.
+ * @param text - the file's contents.
+ * @returns where the list is, or null when the layout is not one this edits with certainty.
+ */
+export declare function readExcludeList(text: string): ExcludeList | null;
+/**
+ * The file with exactly `name@version` listed for this package: older entries
+ * of the same package are replaced, every other line stays as it is.
+ * @param text - pnpm-workspace.yaml as it is.
+ * @param name - the plugin's package name.
+ * @param version - the release about to be installed.
+ * @returns the new text (the same text when nothing needs to change), or null when it cannot be edited with certainty.
+ */
+export declare function excludeRelease(text: string, name: string, version: string): string | null;
+/**
+ * The profile directory pnpm installs plugins in: the same `profileContext`
+ * the plugin manager installs through. Environment variables are not used: a
+ * harness started from another profile's shell inherits that profile's.
+ * @param ctx - the plugin context.
+ * @returns the directory, or null outside a dsh profile.
+ */
+export declare function profileDir(ctx: Context): string | null;
+/**
+ * Whether the exclusion can be written: the file exists, reads with certainty and is writable.
+ * @param dir - the profile directory.
+ * @param name - the plugin's package name.
+ * @returns true when {@link writeReleaseExclusion} would succeed short of a race.
+ */
+export declare function canExcludeRelease(dir: string, name: string): Promise<boolean>;
+/**
+ * List exactly `name@version` in the profile's `minimumReleaseAgeExclude`,
+ * under the profile's package lock (the one the plugin manager holds while it
+ * changes the profile), with an atomic replace.
+ * @param dir - the profile directory.
+ * @param name - the plugin's package name.
+ * @param version - the release about to be installed.
+ * @param waitMs - how long to wait for another package operation in the profile.
+ * @returns true when the file lists the version; false when it was left as it was.
+ */
+export declare function writeReleaseExclusion(dir: string, name: string, version: string, waitMs?: number): Promise<boolean>;
+export {};

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

@@ -4,12 +4,14 @@
  * finish, nothing after finish.
  */
 import type { StreamChunk, TokenUsage } from '@deepseek-ai/dsh-llm';
-import { type SseEvent } from '@adaptiqai/core';
+import { type MemoryNotice, type SseEvent } from '@adaptiqai/core';
 export { mapUsage, parseSse, type SseEvent } from '@adaptiqai/core';
 /** Hooks the translator calls as the stream unfolds. */
 export interface TranslateHooks {
     /** A server progress frame (`adaptiq.progress`): stage such as `context.preparing` or `inference.queued`. */
     onProgress?(stage: string, elapsedMs: number | null): void;
+    /** The engine put idle conversations to sleep, or suggests which may (`adaptiq.memory`). */
+    onMemoryNotice?(notice: MemoryNotice): void;
     /** The first visible output (text, thinking or a tool call) arrived. */
     onFirstOutput?(): void;
     /** An in-band error: map it to the thrown failure. */

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

@@ -1,5 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type { Workspace } from '@adaptiqai/core';
+import { type Workspace } from '@adaptiqai/core';
 /**
  * The media type for a file name.
  * @param name - file name.

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

@@ -0,0 +1,43 @@
+/**
+ * Updating the plugin from inside the harness: the profile's plugin manager
+ * (`pluginManager`, the service behind the Plugins page) installs the
+ * version, and the loader in lib/index.js swaps the running Host half for the
+ * new code (see entry.ts).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type PluginUpdater, UpdateFailure } from '@adaptiqai/core';
+/** What lib/index.js offers the code it loads; absent when this module was loaded directly. */
+export interface HostRuntime {
+    /** The version in the package.json on disk now, or null when it cannot be read. */
+    installedVersion(): string | null;
+    /** Whether the code on disk can replace the running code in place (same Remote methods and composition). */
+    canReload(): Promise<boolean>;
+    /** Replace the running Host half with the code on disk, right after this call returns. */
+    reload(): Promise<'reloaded' | 'restart'>;
+}
+interface ChangeResultLike {
+    application: 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
+    error?: {
+        code: string;
+        diagnostic?: string;
+    };
+    packageResult?: {
+        kind?: string;
+        output?: string;
+    };
+}
+/**
+ * Why an install did not finish, in the words the person is told.
+ * @param result - the plugin manager's outcome.
+ * @returns the failure.
+ */
+export declare function installFailure(result: ChangeResultLike): UpdateFailure;
+/**
+ * The updater for this harness.
+ * @param ctx - the plugin context.
+ * @param name - the plugin's package name.
+ * @param runtime - the loader's reload hooks, when lib/index.js loaded this code.
+ * @returns the updater the Workspace drives.
+ */
+export declare function harnessUpdater(ctx: Context, name: string, runtime: HostRuntime | undefined): PluginUpdater;
+export {};

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

@@ -4,7 +4,7 @@
  * model's catalog entry.
  */
 import type { GenerateOptions, RequestMessage } from '@deepseek-ai/dsh-llm';
-import { type CatalogModel } from '@adaptiqai/core';
+import { type CatalogModel, type SessionRole, type UserTurn } from '@adaptiqai/core';
 /** One Chat Completions message. */
 export type WireMessage = {
     role: 'system';
@@ -83,6 +83,13 @@ export declare function recallSnapshot(text: string, references: readonly Refere
  * @returns the text of each of the person's messages, oldest first.
  */
 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).
+ * @param messages - the request history.
+ * @returns the person's turns, oldest first.
+ */
+export declare function userTurns(messages: readonly RequestMessage[]): UserTurn[];
 /**
  * Convert the harness history to Chat Completions messages.
  * @param options - the harness request.
@@ -98,10 +105,32 @@ export declare function wireMessages(options: Pick<GenerateOptions, 'messages' |
  * @returns the JSON body.
  */
 export declare function buildChatBody(options: GenerateOptions, model: CatalogModel | null, extras: WireExtras): Record<string, unknown>;
+/** The session that started a session, and how it relates to it. */
+export interface ParentSession {
+    readonly parentSessionId: string;
+    readonly role: SessionRole;
+}
+/** What a harness session header says about where the session came from. */
+export interface SessionOrigin {
+    readonly parentSession?: string;
+    readonly origin?: string;
+    readonly delegationDepth?: number;
+}
+/**
+ * The parent of a harness session. A subagent (`origin: 'subagent'` or a
+ * delegation depth) works for its parent: `helper`; a member of the parent's
+ * Agent Team is its own line of work: `track`. A root session and a fork the
+ * person made (`parentSession` without delegation) have none.
+ * @param header - the session's header.
+ * @param teammate - whether the Agent Team service counts the session as a teammate.
+ * @returns the parent and role, or undefined.
+ */
+export declare function parentSession(header: SessionOrigin | undefined, teammate: boolean): ParentSession | undefined;
 /**
  * The session headers for one call. A title request carries none: it reuses the
  * conversation id with a different history and must not fork the saved conversation.
  * @param options - the harness request.
+ * @param parent - the session that started this one, if any.
  * @returns header name → value.
  */
-export declare function sessionHeaders(options: Pick<GenerateOptions, 'sessionId' | 'purpose'>): Record<string, string>;
+export declare function sessionHeaders(options: Pick<GenerateOptions, 'sessionId' | 'purpose'>, parent?: ParentSession): Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptiqai/deepseek-harness",
-  "version": "0.2.6",
+  "version": "0.2.12",
   "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",
@@ -42,6 +42,7 @@
     "cordis.patch.yml",
     "locale/*.json",
     "lib/index.js",
+    "lib/host.js",
     "lib/client.js",
     "lib/typert.host.js",
     "lib/typert.host.d.ts",
@@ -89,7 +90,14 @@
     "react-dom": "~18.3.1",
     "typescript": "~5.9.3",
     "vitest": "~3.2.7",
-    "@adaptiqai/core": "0.2.6"
+    "@adaptiqai/core": "workspace:*"
+  },
+  "scripts": {
+    "link-dsh": "node scripts/link-dsh.mjs",
+    "build": "node scripts/gen-typert.mjs && node scripts/build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "pack:local": "npm run build && pnpm pack --pack-destination ../../dist"
   },
   "repository": {
     "type": "git",
@@ -98,12 +106,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "link-dsh": "node scripts/link-dsh.mjs",
-    "build": "node scripts/gen-typert.mjs && node scripts/build.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "pack:local": "npm run build && pnpm pack --pack-destination ../../dist"
   }
-}
+}