@deepseek-ai/dsh-agent-presets 0.0.1-rc.1

package/lib/types/types.d.ts

@@ -0,0 +1,83 @@
+/** Agent-preset vocabulary shared by discovery, mounting, and consumers. @module @deepseek-ai/dsh-agent-presets/types */
+/**
+ * Where a preset's composition came from. A `system` preset ships with the
+ * deployment; a `user` preset was authored locally, by a person or by an
+ * agent, and therefore carries the same trust as shell access.
+ */
+export type PresetTrust = 'system' | 'user';
+/**
+ * Ids a preset directory may use.
+ *
+ * The id becomes a path segment, so this is a containment boundary rather than
+ * a style rule: `..`, a separator, or an absolute-looking name would place the
+ * composition outside the root the deployment authorised. Discovery shares it:
+ * a directory whose name no copy could ever claim is not a preset slot.
+ */
+export declare const PRESET_ID: RegExp;
+/** One preset directory that carries a mountable agent composition. */
+export interface AgentPreset {
+    /** Stable identifier; the preset directory's name. */
+    readonly id: string;
+    /** Trust recorded from the root this preset was discovered under. */
+    readonly trust: PresetTrust;
+    /** Absolute path of the preset's agent composition file. */
+    readonly path: string;
+    /** Display name from the preset's own metadata; absent falls back to {@link id}. */
+    readonly name?: string;
+    /** One sentence on what this preset is for, when it published one. */
+    readonly description?: string;
+    /** Declared position within its group; absent sorts after those that declare one. */
+    readonly order?: number;
+    /**
+     * Why this preset cannot compose a session, absent when it can. A broken
+     * preset stays on the roster — hiding it would leave its directory blocking
+     * the id with nothing to see or delete — but every mounting path refuses it
+     * up front with this reason instead of failing deep inside the loader.
+     */
+    readonly broken?: string;
+}
+/** One directory scanned for preset subdirectories. */
+export interface PresetRoot {
+    /** Directory holding one subdirectory per preset; a leading `~` expands. */
+    path: string;
+    /** Trust recorded on every preset discovered under this root. */
+    trust: PresetTrust;
+}
+/** Plugin config: which preset is the default, and where presets live. */
+export interface Config {
+    /** Preset id mounted when a caller names none. Missing at mount time fails loud. */
+    default: string;
+    /** Scanned roots in precedence order; an earlier root wins a duplicate id. */
+    roots: PresetRoot[];
+}
+/**
+ * No configured root supplies the requested preset.
+ *
+ * Separate from a mount failure because the two mean different things to a
+ * caller: an unknown id is a bad request, while an unusable composition is a
+ * broken preset the deployment must fix.
+ */
+export declare class UnknownPresetError extends Error {
+    /** The id that was requested. */
+    readonly presetId: string;
+    /** Ids the roster does supply, for the caller to offer instead. */
+    readonly available: readonly string[];
+    constructor(
+    /** The id that was requested. */
+    presetId: string, 
+    /** Ids the roster does supply, for the caller to offer instead. */
+    available: readonly string[]);
+}
+/** A preset exists but its composition cannot be installed. */
+export declare class PresetMountError extends Error {
+    /** The preset whose composition failed. */
+    readonly presetId: string;
+    /** Why it failed, without this package's own message prefix. */
+    readonly reason: string;
+    constructor(
+    /** The preset whose composition failed. */
+    presetId: string, 
+    /** Why it failed, without this package's own message prefix. */
+    reason: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@deepseek-ai/dsh-agent-presets",
+  "description": "Per-session agent composition from preset cordis.yml files for the DeepSeek Harness",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/preset/agent-presets"
+  },
+  "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"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "@deepseek-ai/cordis-plugin-include": "^1.0.5-rc.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
+    "@deepseek-ai/dsh-atomic-write": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-paths": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.0.1-rc.1"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis-plugin-include": "^1.0.5-rc.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-atomic-write": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-paths": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-settings-local": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1"
+  }
+}