dsh-loop-engine 1.0.0-rc10

package/lib/types/settings.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared loop-engine identity, namespace, and schema.
+ *
+ * The namespace literal lives in the zero-import `./namespace.ts` so both
+ * halves agree on the section name: the node half brands it as a
+ * `SettingsNamespace`, while the browser half imports the same literal
+ * without pulling the host-side `dsh-settings` service into the client
+ * bundle (cross-plugin value imports go through cordis services, and
+ * `settings-scope.ts` follows the same discipline).
+ *
+ * @module dsh-loop-engine/settings
+ */
+import z from '@deepseek-ai/schemastery';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
+export { LOOP_ENGINE_SETTINGS_NAMESPACE_LITERAL } from './namespace.ts';
+/** The installed engine driving new Agent turns. */
+export declare const LOOP_ENGINE_IDS: readonly ["in-process", "claude-code", "codex", "pi", "kimi"];
+/** Installed agent loop engine id. */
+export type LoopEngineId = (typeof LOOP_ENGINE_IDS)[number];
+/** Stored and composed loop engine selection. */
+export interface LoopEngineSettings {
+    /** The engine future Agents are created on. */
+    engine: LoopEngineId;
+    /** Whether the composer's loop engine picker is shown on the chat page. */
+    showInComposer: boolean;
+}
+/** Schema of the loop engine settings section. */
+export declare const LOOP_ENGINE_SETTINGS_SCHEMA: z<LoopEngineSettings>;
+/** The shared literal branded as a settings namespace on the node side. */
+export declare function loopEngineSettingsNamespace(): SettingsNamespace;
+//# sourceMappingURL=settings.d.ts.map

package/lib/types/skills.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Claude Code skill provider: discovers skills from the project's `.claude/`
+ * directory, the user-level `~/.claude/skills/` directory, and the project's
+ * `CLAUDE.md` file, using the same YAML-frontmatter + markdown format as DSH
+ * skills.
+ *
+ * @module dsh-loop-engine/skills
+ */
+export interface SkillInvocationPolicy {
+    readonly modelInvocable: boolean;
+    readonly userInvocable: boolean;
+}
+export type SkillSource = string;
+export interface SkillCandidate {
+    readonly name: string;
+    readonly description: string;
+    readonly whenToUse?: string;
+    readonly invocation: SkillInvocationPolicy;
+    readonly source: SkillSource;
+    readonly provider: string;
+    readonly rank: number;
+    readonly locator: unknown;
+    readonly path?: string;
+    readonly resourceBase?: {
+        readonly kind: string;
+        readonly path: string;
+    };
+}
+export interface SkillDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly whenToUse?: string;
+    readonly invocation: SkillInvocationPolicy;
+    readonly source: SkillSource;
+    readonly provider: string;
+    readonly content: string;
+    readonly path?: string;
+    readonly resourceBase?: {
+        readonly kind: string;
+        readonly path: string;
+    };
+}
+export interface SkillLookupOptions {
+    readonly cwd?: string;
+    readonly signal?: AbortSignal;
+}
+export interface SkillProvider {
+    readonly name: string;
+    list(options: SkillLookupOptions): Promise<readonly SkillCandidate[] | {
+        candidates: readonly SkillCandidate[];
+        complete: boolean;
+    }>;
+    get(candidate: SkillCandidate, options: SkillLookupOptions): Promise<SkillDefinition | undefined>;
+}
+export interface SkillProviderControl {
+    readonly signal: AbortSignal;
+    invalidate(): void;
+}
+/** One parsed agents-skill standard skill: frontmatter metadata plus the body. */
+export interface ParsedSkill {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    invocation: SkillInvocationPolicy;
+    content: string;
+}
+/**
+ * Parse one agents-skill standard file: YAML frontmatter (`name`,
+ * `description`, optional `whenToUse`/`disable-model-invocation`/
+ * `user-invocable`) plus the markdown body.
+ * @param raw - the raw file content.
+ * @returns the parsed skill, or `undefined` when the file is not a skill.
+ */
+export declare function parseSkillFile(raw: string): ParsedSkill | undefined;
+/**
+ * Skill provider that discovers skills from Claude Code's standard locations:
+ *   - `<project>/.claude/skills/` — project skills
+ *   - `~/.claude/skills/` — personal skills
+ * Each location accepts both Claude Code layouts: a `<name>/SKILL.md`
+ * directory (its directory becomes the resource base) and a flat `<name>.md`
+ * file. `CLAUDE.md` in the project root is also read when it carries skill
+ * frontmatter.
+ */
+export declare class ClaudeCodeSkillProvider implements SkillProvider {
+    private readonly control;
+    readonly name = "claude-code";
+    constructor(control: SkillProviderControl);
+    list(options: SkillLookupOptions): Promise<readonly SkillCandidate[]>;
+    get(candidate: SkillCandidate, _options: SkillLookupOptions): Promise<SkillDefinition | undefined>;
+}
+export declare function findProjectRoot(cwd: string): Promise<string>;
+export default ClaudeCodeSkillProvider;
+//# sourceMappingURL=skills.d.ts.map

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "dsh-loop-engine",
+  "description": "Web-switchable agent loop engine selection for the DeepSeek Harness - out-of-tree plugin (Claude Code / Codex / Pi / Kimi Code drivers) maintained by @kuun993, zero main-repo changes",
+  "version": "1.0.0-rc10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": "github:kuun993/dsh-loop-engine",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web",
+      "external": [
+        "@deepseek-ai/dsh-client-locale/client",
+        "@deepseek-ai/dsh-client-ui-settings/client",
+        "@deepseek-ai/dsh-api-remotes/client",
+        "@deepseek-ai/dsh-settings/types"
+      ]
+    }
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.220",
+    "@anthropic-ai/sdk": "0.93.0",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@earendil-works/pi-coding-agent": "0.84.3",
+    "@openai/codex": "0.149.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-subprocess": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.1.2-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-attachment": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-subprocess-local": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
+    "@types/node": "^22.20.0",
+    "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "esbuild": "^0.28.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vite": "^7.0.0",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.8"
+  }
+}