@hydraharness/harness-session-title-first-prompt-llm 0.1.1-rc.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @hydraharness/harness-session-title-first-prompt-llm
+
+Optional `ctx.sessionTitle` provider that summarizes the first eligible human message through `ctx.llm`. It registers the `first-prompt` cadence, runs automatically only when a fresh non-fork session first creates its fallback, and attributes the result to that message's exact seq. An automatic failure retains the fallback and is retried only through `ctx.sessionTitle.refresh()`.
+
+The plugin uses the complete required [shared LLM configuration](../session-title-llm/README.md#configuration). Omit both `provider` and `model` to inherit the exact route from the current logged main request, or set both to route title generation independently.
+
+## Model Experience
+
+### First-message title request
+
+#### What the model sees
+
+The title model receives the shared title instruction and a JSON array containing only the first eligible human message. Later prompts and inherited fork history do not trigger another automatic call.
+
+#### Token effect
+
+At most one automatic auxiliary request is made for a fresh session, bounded by `maxInputBytes` and `maxOutputTokens`; explicit refreshes may make additional calls. The main agent request gains zero tokens.
+
+#### KV Cache effect
+
+No main-request invalidation. The auxiliary request uses the configured or logged route and has provider-specific cache behavior.
+
+## Known Limitations and Deferred Work
+
+- The first message alone may cease to represent a long-running session; use the all-messages provider when later prompts should retitle it.
+- A fork keeps its inherited title and never runs this provider automatically, even when its seeded first message came from the parent.

package/lib/index.js

@@ -0,0 +1,34 @@
+import z from "@hydraharness/schemastery";
+import { SessionTitleLlmConfigFields, registerSessionTitleLlmProvider } from "@hydraharness/harness-session-title-llm";
+//#region lib/types/index.js
+/** First-human-message model provider for `ctx.sessionTitle`. */
+const name = "session-title-first-prompt-llm";
+const inject = [
+	"sessionTitle",
+	"llm",
+	"sessions"
+];
+/** Loader schema shared with the all-messages provider. */
+const Config = z.object({
+	targetWords: SessionTitleLlmConfigFields.targetWords,
+	targetCjkCharacters: SessionTitleLlmConfigFields.targetCjkCharacters,
+	maxInputBytes: SessionTitleLlmConfigFields.maxInputBytes,
+	maxOutputTokens: SessionTitleLlmConfigFields.maxOutputTokens,
+	timeoutMs: SessionTitleLlmConfigFields.timeoutMs,
+	provider: SessionTitleLlmConfigFields.provider,
+	model: SessionTitleLlmConfigFields.model
+});
+/**
+* Register the first-prompt model provider.
+* @param ctx - context exposing session-title, LLM, and session services.
+* @param config - required route, target, byte, token, and timeout policy.
+*/
+function apply(ctx, config) {
+	registerSessionTitleLlmProvider(ctx, config, name, "first-prompt", (messages) => {
+		const first = messages[0];
+		if (first === void 0) throw new Error("first-prompt title provider requires one human message");
+		return [first];
+	});
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@hydraharness/harness-session-title-first-prompt-llm`.
+* @module @hydraharness/harness-session-title-first-prompt-llm/invariant
+*/
+const PACKAGE_NAME = "@hydraharness/harness-session-title-first-prompt-llm";
+/** Cordis companion plugin name. */
+const name = "session-title-first-prompt-llm-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this thin provider delegates request and result validation to the shared
+* title service and LLM helper and retains no independent mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,17 @@
+/** First-human-message model provider for `ctx.sessionTitle`. */
+import type { Context } from '@hydraharness/cordis';
+import z from '@hydraharness/schemastery';
+import type { SessionTitleLlmConfig } from '@hydraharness/harness-session-title-llm';
+export declare const name = "session-title-first-prompt-llm";
+export declare const inject: string[];
+/** Required LLM policy; this plugin adds no defaults. */
+export type Config = SessionTitleLlmConfig;
+/** Loader schema shared with the all-messages provider. */
+export declare const Config: z<Config>;
+/**
+ * Register the first-prompt model provider.
+ * @param ctx - context exposing session-title, LLM, and session services.
+ * @param config - required route, target, byte, token, and timeout policy.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@hydraharness/harness-session-title-first-prompt-llm`.
+ * @module @hydraharness/harness-session-title-first-prompt-llm/invariant
+ */
+import type { Context } from '@hydraharness/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "session-title-first-prompt-llm-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@hydraharness/harness-session-title-first-prompt-llm",
+  "description": "First-message LLM provider plugin for Hydra harness session titles",
+  "hydra": {
+    "plugin": {
+      "application": "Generate a conversation title from its first user prompt with the configured model."
+    }
+  },
+  "version": "0.1.1-rc.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaiHongPhong1902/Hydra-Harness.git",
+    "directory": "packages/session/session-title-first-prompt-llm"
+  },
+  "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"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6",
+    "@hydraharness/harness-session": "^0.1.1-rc.6",
+    "@hydraharness/harness-llm": "^0.1.1-rc.6",
+    "@hydraharness/harness-session-title-llm": "^0.1.1-rc.6",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-session-title": "^0.1.1-rc.6"
+  },
+  "dependencies": {
+    "@hydraharness/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@hydraharness/cordis-plugin-include": "^1.0.7",
+    "@hydraharness/cordis-plugin-loader": "^1.0.3",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6",
+    "@hydraharness/harness-session": "^0.1.1-rc.6",
+    "@hydraharness/harness-llm": "^0.1.1-rc.6",
+    "@hydraharness/harness-session-title": "^0.1.1-rc.6",
+    "@hydraharness/harness-session-title-llm": "^0.1.1-rc.6",
+    "@hydraharness/cordis": "^4.0.2"
+  }
+}