@y0shua1ee/dsh-auto-memory 0.3.3 → 0.4.0

package/lib/types.d.ts

@@ -0,0 +1,122 @@
+/** One text block in a user-role message. */
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+/** Rule identity carried by an injected rules message. */
+export interface RuleRef {
+    key: string;
+    path: string;
+    scope: RuleScope;
+    digest: string;
+}
+/** Message metadata used to recognize and deduplicate injected snapshots. */
+export interface MessageSource {
+    kind: string;
+    form?: string;
+    projectKey?: string;
+    digest?: string;
+    baseline?: boolean;
+    rules?: RuleRef[];
+    [field: string]: unknown;
+}
+/** The message shape the memory and rules features inject. */
+export interface Message {
+    id: string;
+    role?: string;
+    content: TextContent[];
+    source?: MessageSource;
+}
+/** Session surface nodes, newest last. */
+export interface Surface {
+    nodes: number[];
+}
+/** One recorded session event. */
+export interface SessionEvent {
+    type?: string;
+    data?: Message;
+}
+/** Session header fields the plugin reads. */
+export interface SessionHeader {
+    cwd?: string;
+    origin?: string;
+    delegationDepth?: number;
+    [field: string]: unknown;
+}
+/** The session slice the plugin uses. */
+export interface Session {
+    header?: SessionHeader;
+    surface: Surface;
+    eventAt(seq: number): SessionEvent | undefined;
+}
+/** The inbox queue used to hold a message for the next step. */
+export interface Inbox {
+    nextStep: Message[];
+    prepend(queue: string, message: Message): void;
+    replace(id: string, message: Message): void;
+    remove(id: string): void;
+}
+/** The calling agent. */
+export interface Agent {
+    session: Session;
+    inbox: Inbox;
+}
+export interface EnterDecision {
+    kind: "enter";
+    messages: Message[];
+}
+export interface RejectDecision {
+    kind: "reject";
+}
+export type PreStepDecision = EnterDecision | RejectDecision;
+export type PreStepNext = () => Promise<PreStepDecision>;
+export interface PreStepPayload {
+    agent: Agent;
+    messages: Message[];
+    step: number;
+    signal: AbortSignal;
+}
+export type PreStepHandler = (payload: PreStepPayload, next: PreStepNext) => Promise<PreStepDecision>;
+/** The execution context passed to a tool body. */
+export interface ToolExec {
+    agent?: Agent;
+    signal?: AbortSignal;
+}
+/** The normalized result observed by a `tools/result` listener. */
+export interface ToolResultEvent {
+    isError?: boolean;
+}
+/** The execution record observed by a `tools/result` listener. */
+export interface ToolExecEvent {
+    name?: string;
+    arguments?: {
+        file_path?: unknown;
+    };
+    agent?: Agent;
+    signal?: AbortSignal;
+}
+export type RuleScope = "user" | "project";
+export interface SystemPromptSection {
+    name: string;
+    order: number;
+    text: string;
+}
+export interface Logger {
+    warn(message: string, ...args: unknown[]): void;
+}
+/** The Cordis services this plugin consumes. */
+export interface PluginContext {
+    tools: {
+        register(tool: unknown): void;
+    };
+    systemPrompt: {
+        section(section: SystemPromptSection): void;
+        getSectionOrder(key: string): number;
+    };
+    workingDirectory: {
+        ensure(agent: Agent, signal?: AbortSignal): Promise<string>;
+    };
+    on(event: "agent/pre-step", handler: PreStepHandler): void;
+    on(event: "tools/result", handler: (exec: ToolExecEvent, result: ToolResultEvent) => void): void;
+    logger?: Logger;
+}

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@y0shua1ee/dsh-auto-memory",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Persistent project memory and Claude Code-compatible rules for DeepSeek Harness.",
   "type": "module",
   "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "exports": {
     ".": "./lib/index.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
@@ -48,11 +49,6 @@
       "optional": true
     }
   },
-  "scripts": {
-    "test": "node --test test/*.test.mjs",
-    "test:integration": "node --import ./test/register.mjs --test test/*.test.mjs",
-    "extract-runtime": "node scripts/extract-runtime.mjs"
-  },
   "author": "Ares Lee",
   "homepage": "https://github.com/y0shua1ee/dsh-auto-memory#readme",
   "repository": {
@@ -73,5 +69,16 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test test/*.test.mjs",
+    "test:integration": "tsc -p tsconfig.json && node --import ./test/register.mjs --test test/*.test.mjs",
+    "extract-runtime": "node scripts/extract-runtime.mjs"
   }
-}
+}