@poco-ai/agentero-dsh-host 0.0.0-stage → 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,55 @@
+import type { Context, Volatile } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+/** Cordis plugin name. The loader row id matches this name. */
+export declare const name = "agentero-host";
+/** HTTP routes are registered on the composition web server. `agents` cites into a session. `tools` exposes the vault to the model. */
+export declare const inject: string[];
+/**
+ * Optional host settings. Omitted fields use the defaults below. The three
+ * live fields arrive as references so the Plugins page can edit them without
+ * remounting this plugin.
+ */
+export interface Config {
+    /** Vault directory. Empty until a later step opens it. */
+    vault: Volatile<string>;
+    /** Executable name used to reach the Agentero CLI. */
+    agenteroBin: Volatile<string>;
+    /** Agentero desktop settings file. Empty resolves `$XDG_CONFIG_HOME/agentero/settings.json`. */
+    agenteroSettings: string;
+    /** Last selected knowledge bases in this DSH profile. */
+    recentVaults: Volatile<string[]>;
+    /** Optional registered Harness route; both fields must be supplied together. */
+    translationProvider: string;
+    translationModel: string;
+    translationSystemPrompt: string;
+    translationUserPrompt: string;
+}
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    vault: z<string, string, "volatile-defined">;
+    agenteroBin: z<string, string, "volatile-defined">;
+    agenteroSettings: z<string, string, "defined">;
+    recentVaults: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    translationProvider: z<string, string, "defined">;
+    translationModel: z<string, string, "defined">;
+    translationSystemPrompt: z<string, string, "defined">;
+    translationUserPrompt: z<string, string, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    vault: z<string, string, "volatile-defined">;
+    agenteroBin: z<string, string, "volatile-defined">;
+    agenteroSettings: z<string, string, "defined">;
+    recentVaults: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    translationProvider: z<string, string, "defined">;
+    translationModel: z<string, string, "defined">;
+    translationSystemPrompt: z<string, string, "defined">;
+    translationUserPrompt: z<string, string, "defined">;
+}>>, "plain">;
+/**
+ * Read `vault` and `agenteroBin`. Serve paper list, PDF bytes, marks, and
+ * note files under `/agentero/api`. `POST /agentero/api/context` queues a
+ * citation on the named session without waking its driver.
+ * `vault`, `agenteroBin`, and `recentVaults` are volatile, so the Plugins page
+ * writes them through DSH's settings service while this instance keeps running.
+ * @param ctx - Host plugin context.
+ * @param config - Loader config with live references. Missing fields use the defaults.
+ */
+export declare function apply(ctx: Context, config?: Config): void;