@avantf/dsh-mem 0.1.0

package/lib/types/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @avantf/dsh-mem — DSH native Cordis host plugin (standard plugin form).
+ *
+ * Built inside the DSH harness workspace (its `@deepseek-ai/dsh-tools` /
+ * `@deepseek-ai/dsh-typert-protocol` deps resolve there). It does NOT use the
+ * dynamic-package `harness` builtin — model tools register via
+ * `ctx.tools.register(defineTool(...))` and the client↔host bridge is a
+ * `TypertRemoteService`, so a normal DSH profile plugin can run it.
+ *
+ * Tool inputs are declared explicitly for the model: the contract's zod unions
+ * are flattened into DSH ParameterSchemaSpec with per-field `description`,
+ * array `items`, enums and integer types, and every call is re-validated with
+ * the contract schema before dispatch so a bad call returns a structured error
+ * instead of a raw runtime exception.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { type AvantfRuntime } from '@avantf/mem';
+import { type RemoteEnvelope } from '@avantf/mem-contract';
+export declare const name = "avantf-mem";
+export { inject } from './inject.js';
+export { KNOWLEDGE_PROMPT_SECTION, MEMORY_PROMPT_SECTION } from './prompt.js';
+export interface Config {
+    mode?: 'cordis' | 'mcp';
+    dataHome?: string;
+}
+export declare const Config: z<Config>;
+type WireArgs = Record<string, unknown>;
+/**
+ * Pass-through gateway mirroring the five agent tools. Every payload is
+ * re-validated with the contract zod union before dispatch (same guarantee the
+ * tools give the model), and results are wrapped in the contract's
+ * `{ok:true,value}` / `{ok:false,error,violations}` RemoteEnvelope the client decodes.
+ */
+export declare class AvantfMemGateway extends TypertRemoteService {
+    private readonly rt;
+    constructor(ctx: Context, rt: AvantfRuntime);
+    private call;
+    remember(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    recall(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    admin(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    kb(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    query(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    /**
+     * UI-only: what IS this string? Answered against the ingestion boundary, so the UI can label the
+     * input and pick the right `kb_manage` action (URL → fetch, file → ingest, directory → import,
+     * text → ingest the string itself, missing → refuse and say why).
+     */
+    classifySource(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    /** UI-only: one directory listing for the 选择 picker (same boundary as ingestion). */
+    browseDir(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    /**
+     * UI-only: the 知识页 domain picker's options — the configured `knowledge.domains` allowlist
+     * together with the domains the library already holds — plus whether the allowlist is active
+     * (non-empty). The host is the only side that knows either half.
+     */
+    kbDomains(_args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    /**
+     * UI-only: add one 知识域 to the store config's `domains` allowlist AND to the live set, so the
+     * 知识 tab's 「+」 works without a restart. No agent tool mirrors this on purpose — the model must
+     * stay bounded by the configured list, while the user can widen it.
+     */
+    kbAddDomain(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+    /**
+     * UI-only: hand one managed document file — or the directory that holds it — to the user's
+     * editor. No agent tool mirrors this, so it carries its own envelope instead of going through
+     * `dispatchToolKey`; the path is resolved from `doc_id` here, so nothing the client sends is
+     * trusted.
+     */
+    openDoc(args: WireArgs): Promise<RemoteEnvelope<unknown>>;
+}
+export declare function apply(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EAOL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAcL,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAA;AAiB7B,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AAkDF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAOvC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBACtB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa;YAK7B,IAAI;IAelB,QAAQ,CAAC,IAAI,EAAE,QAAQ;IAMvB,MAAM,CAAC,IAAI,EAAE,QAAQ;IAMrB,KAAK,CAAC,IAAI,EAAE,QAAQ;IAMpB,EAAE,CAAC,IAAI,EAAE,QAAQ;IAOjB,KAAK,CAAC,IAAI,EAAE,QAAQ;IAIpB;;;;OAIG;IAEG,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAUtE,qFAAqF;IAE/E,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAUjE;;;;OAIG;IAEG,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAQlE;;;;OAIG;IAEG,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAUnE;;;;;OAKG;IAEG,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;CAiBhE;AA+ID,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2TvE"}