@monkey-mini-app/dsh-mini-app 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,140 @@
+import { HostConfig, AbsolutePath, AppCallContext, AgentRunOptions, HostCapabilities, LlmRunOptions, HostLifecycle, HostServices, LogLevel, ModelRouteOptions, JsonInstructOptions, ThemeResource, CustomThemePalette } from '@monkey-mini-app/host';
+
+type DshPluginConfig = {
+    runtimeRoot?: string;
+};
+/** Locate runtimeRoot from plugin config only when provided; else bootstrap seed path. */
+declare function resolveRuntimeRoot(config?: DshPluginConfig): AbsolutePath;
+/**
+ * Runtime load: read host.json, no field defaults.
+ * Missing file fails loud with an install/init hint.
+ */
+declare function loadPluginHostConfig(config?: DshPluginConfig): HostConfig;
+
+type DshToolSchema = {
+    name?: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+};
+type DshToolService = {
+    register?: (tool: unknown) => void | (() => void);
+    get?: (name: string) => unknown;
+    schemas?: (scope?: unknown) => DshToolSchema[];
+    list?: () => unknown;
+    /** Agent-scoped mask; `deny` / `allow` must name known global tools. */
+    restrict?: (filter: {
+        allow?: string[];
+        deny?: string[];
+    }) => () => void;
+};
+type DshLlmService = {
+    stream: (req: unknown) => AsyncIterable<unknown>;
+};
+type DshCtx = {
+    tools?: DshToolService;
+    get?: (name: string) => unknown;
+    provide?: (key: string, value: unknown) => void;
+    [key: string]: unknown;
+};
+
+type DshAgentHelpers = {
+    SessionId: (id: string) => unknown;
+    createUserMessage: (input: {
+        content: unknown[];
+        source: unknown;
+    }) => unknown;
+    finalAssistantOutput: (events: readonly unknown[]) => unknown[] | undefined;
+};
+type AgentOneShotDeps = {
+    loadHelpers?: () => Promise<DshAgentHelpers | null>;
+    /** Override poll interval for tests (ms). */
+    pollMs?: number;
+    /** Mini-app call context (appId/appDir/signal/hostLlm). */
+    callCtx?: AppCallContext;
+};
+/**
+ * Run one ephemeral dsh Agent to completion and return the final assistant text.
+ * `opts` is caller intent (never mutated). Call facts come from `deps.callCtx`.
+ */
+declare function runDshAgentOneShot(dsh: DshCtx, goal: string, opts?: AgentRunOptions, deps?: AgentOneShotDeps): Promise<string>;
+
+/** dsh ctx-facing capabilities. Fail loud when the host has no llm/agent/tool/mcp. */
+declare class DshCapabilities implements HostCapabilities {
+    private readonly dsh;
+    constructor(dsh: DshCtx);
+    bash(_ctx: AppCallContext, command: string): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    llm(ctx: AppCallContext, prompt: string, opts?: LlmRunOptions): Promise<string>;
+    agent(ctx: AppCallContext, goal: string, opts?: AgentRunOptions): Promise<string>;
+    tool(_ctx: AppCallContext, name: string, args?: Record<string, unknown>): Promise<unknown>;
+    mcp(_ctx: AppCallContext, name: string, args?: Record<string, unknown>): Promise<unknown>;
+    credentials(_ctx: AppCallContext): Record<string, string>;
+    config(_ctx: AppCallContext): Record<string, unknown>;
+    listTools(_ctx: AppCallContext): unknown[];
+}
+
+type DshLifecycleOptions = {
+    skillDest?: string;
+};
+/** dsh lifecycle: register mini_app_* tools, install skill, provide services. */
+declare class DshLifecycle implements HostLifecycle {
+    private readonly ctx;
+    private readonly options;
+    private disposers;
+    constructor(ctx: DshCtx, options?: DshLifecycleOptions);
+    attach(_ctx: unknown, services: HostServices): Promise<void>;
+    detach(): Promise<void>;
+    onHostPortChanged(_port: number): void;
+    log(level: LogLevel, message: string, meta?: unknown): void;
+}
+
+/** Same defaults as dsh `agent-default-model` / legacy dsh-adapter. */
+declare const DSH_LLM_FALLBACK: {
+    readonly provider: "deepseek-official";
+    readonly model: "deepseek-v4-flash";
+};
+/**
+ * Resolve provider/model for ctx.llm / ctx.agent.
+ * Follows call opts → AppCallContext.hostLlm → dsh config → agentDefaultModel → fallback.
+ * Never mutates opts.
+ */
+declare function resolveLlmRoute(ctx: DshCtx, opts?: ModelRouteOptions, hostLlm?: {
+    provider?: string;
+    model?: string;
+}): {
+    provider: string;
+    model: string;
+};
+
+declare function withJsonInstruction(prompt: string, opts?: JsonInstructOptions): {
+    prompt: string;
+    system: string | undefined;
+};
+/** When opts.schema is set, peel markdown / preamble so JSON.parse in apps can succeed. */
+declare function coerceSchemaJson(text: string, opts?: JsonInstructOptions): string;
+/** dsh 流格式收集：只收 text-delta + block-end（忽略 reasoning-* / usage）。 */
+declare function collectLlmStream(llmSvc: DshLlmService, prompt: string, route: Required<ModelRouteOptions>, opts?: LlmRunOptions): Promise<string>;
+
+declare function getSkillDir(): string;
+declare function getSkillMarkdown(): string;
+/** Load all files under a named template as path → content (relative to template root). */
+declare function getTemplateFiles(name: string): Record<string, string>;
+declare function getSkeletonTemplateFiles(): Record<string, string>;
+
+declare class DshThemeResource implements ThemeResource {
+    private readonly runtimeRoot;
+    constructor(runtimeRoot: string);
+    runnerCss(): string;
+    listCustomPalettes(): CustomThemePalette[];
+}
+
+declare const packageName = "@monkey-mini-app/dsh-mini-app";
+declare const name = "monkey-mini-app";
+declare const inject: string[];
+
+declare function apply(ctx: DshCtx, config?: DshPluginConfig): Promise<() => void>;
+
+export { type AgentOneShotDeps, DSH_LLM_FALLBACK, type DshAgentHelpers, DshCapabilities, type DshCtx, DshLifecycle, type DshPluginConfig, DshThemeResource, apply, coerceSchemaJson, collectLlmStream, getSkeletonTemplateFiles, getSkillDir, getSkillMarkdown, getTemplateFiles, inject, loadPluginHostConfig, name, packageName, resolveLlmRoute, resolveRuntimeRoot, runDshAgentOneShot, withJsonInstruction };