@hydraharness/harness-tool-media 0.1.1-rc.6

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@hydraharness/harness-tool-media`.
+* @module @hydraharness/harness-tool-media/invariant
+*/
+const PACKAGE_NAME = "@hydraharness/harness-tool-media";
+/** Cordis companion plugin name. */
+const name = "tool-media-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the tool owns no event stream; the tool registry owns
+* settlement and the attachment service owns durable image and video objects.
+*/
+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/gemini-web-retrieve.d.ts

@@ -0,0 +1,11 @@
+/** Retrieve a saved Gemini Web task through the selected account and durable attachment store. */
+import type { Context } from '@hydraharness/cordis';
+import type { VideoConfig } from './video.ts';
+import type { GoogleImageConfig } from './image-google.ts';
+/** Register read-only task recovery with the existing media presentation protocol.
+ * @param ctx - Tools and attachment services, with optional LLM routes.
+ * @param image - Image response and prompt-independent attachment limits.
+ * @param video - Video polling, response, and attachment limits.
+ */
+export declare function registerGeminiWebRetrieve(ctx: Context, image: GoogleImageConfig, video: VideoConfig): void;
+//# sourceMappingURL=gemini-web-retrieve.d.ts.map

package/lib/types/generated-images.d.ts

@@ -0,0 +1,23 @@
+/** Durable attachment admission for decoded provider image results. */
+import { admitEncodedImages, type AttachmentStore, type ImageMediaType } from '@hydraharness/harness-attachment';
+/** Describe stored images without loading image bytes into model history.
+ * @param images - Durable image references available to later media calls.
+ * @returns Attachment ids and image properties in a bounded JSON summary.
+ */
+export declare function generatedImageSummary(images: readonly {
+    attachmentId: string;
+    mediaType: string;
+    width: number;
+    height: number;
+}[]): string;
+/** Store each generated image using its position and media type as the filename.
+ * @param store - session attachment owner.
+ * @param images - encoded final provider images.
+ * @param jobId - Optional provider job id for recovery after attachment admission fails.
+ * @returns admitted references in provider order.
+ */
+export declare function admitGeneratedImages(store: AttachmentStore, images: readonly {
+    data: string;
+    mimeType: ImageMediaType;
+}[], jobId?: string | null): ReturnType<typeof admitEncodedImages>;
+//# sourceMappingURL=generated-images.d.ts.map

package/lib/types/generated-video.d.ts

@@ -0,0 +1,11 @@
+/** Bounded durable video admission shared by generation and saved-task recovery. */
+import type { AttachmentStore, VideoAttachmentRef } from '@hydraharness/harness-attachment';
+/** Persist a completed video without retaining its stream in the transcript.
+ * @param store - Durable attachment owner.
+ * @param response - Completed MP4 or WebM response.
+ * @param maxBytes - Deployment byte limit.
+ * @param signal - Cancellation covering download and storage.
+ * @returns A durable video reference after every byte has been stored.
+ */
+export declare function admitGeneratedVideo(store: AttachmentStore, response: Response, maxBytes: number, signal: AbortSignal): Promise<VideoAttachmentRef>;
+//# sourceMappingURL=generated-video.d.ts.map

package/lib/types/image-google.d.ts

@@ -0,0 +1,36 @@
+/** Google Gemini image generation with durable chat attachments.
+ * @module @hydraharness/harness-tool-media
+ */
+import type { Context } from '@hydraharness/cordis';
+import z from '@hydraharness/schemastery';
+/** Gemini routing and response limits; credentials hold the secret value. */
+export interface GoogleImageConfig {
+    /** Use saved image models before the standalone Gemini route. */
+    useProviderModels?: boolean;
+    /** Restrict configured-model fallback to this provider route. */
+    provider?: string;
+    /** Bare Gemini image model id. */
+    model?: string;
+    /** Gemini REST base URL; HTTP is allowed only on loopback. */
+    baseURL?: string;
+    /** Environment-style credential reference. */
+    apiKeyEnv?: string;
+    /** Cooperative request budget in milliseconds. */
+    timeoutMs?: number;
+    /** Maximum encoded HTTP response bytes, including thought parts. */
+    maxResponseBytes?: number;
+    /** Maximum prompt characters. */
+    maxPromptChars?: number;
+    /** Maximum final images admitted from one response. */
+    maxImages?: number;
+}
+/** Loader defaults for Gemini image generation. */
+export declare const GoogleImageConfig: z<GoogleImageConfig>;
+/**
+ * Register image_generate_google with final images in presentation metadata.
+ * Each call makes one stateless generateContent request without automatic retries.
+ * @param ctx - Tool, credential, and attachment services.
+ * @param config - Loader-validated deployment configuration.
+ */
+export declare function registerGoogleImages(ctx: Context, config: GoogleImageConfig): void;
+//# sourceMappingURL=image-google.d.ts.map

package/lib/types/image-openai.d.ts

@@ -0,0 +1,38 @@
+/** OpenAI image generation with durable attachments and chat presentation.
+ * @module @hydraharness/harness-tool-media
+ */
+import type { Context } from '@hydraharness/cordis';
+import z from '@hydraharness/schemastery';
+/** OpenAI routing and bounded request configuration; secrets remain in credentials. */
+export interface OpenAIImageConfig {
+    /** Use endpoint-compatible models saved on the Models page before the standalone route. */
+    useProviderModels?: boolean;
+    /** Restrict configured-model fallback to this provider route. */
+    provider?: string;
+    /** Additional models tried on the standalone route after an explicit HTTP rejection. */
+    fallbackModels?: string[];
+    /** OpenAI image model id. */
+    model?: string;
+    /** Images API base URL; HTTP is allowed only on loopback. */
+    baseURL?: string;
+    /** Environment-style credential reference. */
+    apiKeyEnv?: string;
+    /** Cooperative request budget in milliseconds. */
+    timeoutMs?: number;
+    /** Maximum encoded HTTP response bytes. */
+    maxResponseBytes?: number;
+    /** Maximum prompt characters. */
+    maxPromptChars?: number;
+    /** Maximum images per call, also bounded by attachment admission. */
+    maxImages?: number;
+}
+/** Loader defaults for the Images API. */
+export declare const OpenAIImageConfig: z<OpenAIImageConfig>;
+/**
+ * Register image_generate over configured Images API routes. Explicit rejections
+ * permit fallback; timeouts and ambiguous failures stop to avoid duplicate billing.
+ * @param ctx - Tool, credential, and attachment services.
+ * @param config - Loader-validated deployment configuration.
+ */
+export declare function registerOpenAIImages(ctx: Context, config: OpenAIImageConfig): void;
+//# sourceMappingURL=image-openai.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,29 @@
+/** Image and video generation tools under one disposable Cordis plugin.
+ * @module @hydraharness/harness-tool-media
+ */
+import type { Context } from '@hydraharness/cordis';
+import z from '@hydraharness/schemastery';
+import { OpenAIImageConfig } from './image-openai.ts';
+import { GoogleImageConfig } from './image-google.ts';
+import { VideoConfig } from './video.ts';
+/** Cordis plugin name. */
+export declare const name = "tool-media";
+/** Services consumed by image and video generation. */
+export declare const inject: string[];
+/** Provider settings for the tools controlled by the shared plugin switch. */
+export interface Config {
+    /** OpenAI-compatible image routing and admission. */
+    openai?: OpenAIImageConfig;
+    /** Native Gemini image routing and admission. */
+    google?: GoogleImageConfig;
+    /** Configured video routing, polling, and storage limits. */
+    video?: VideoConfig;
+}
+/** Loader defaults for all media tools. */
+export declare const Config: z<Config>;
+/** Register all media tools in the same fiber so one switch disposes them together.
+ * @param ctx - Tool, credential, and attachment services.
+ * @param config - Loader-validated settings for each generation API.
+ */
+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-tool-media`.
+ * @module @hydraharness/harness-tool-media/invariant
+ */
+import type { Context } from '@hydraharness/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "tool-media-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/lib/types/media-job.d.ts

@@ -0,0 +1,7 @@
+/** Non-secret provider job correlation carried by completed media responses. */
+/** Read a validated local recovery id without admitting provider URLs into metadata.
+ * @param response - Completed media response.
+ * @returns A local UUID, or undefined for providers without saved-task recovery.
+ */
+export declare function mediaJobId(response: Response): string | undefined;
+//# sourceMappingURL=media-job.d.ts.map

package/lib/types/video.d.ts

@@ -0,0 +1,28 @@
+/** Configured video generation with bounded durable file storage. */
+import type { Context } from '@hydraharness/cordis';
+import z from '@hydraharness/schemastery';
+/** Video routing and storage limits; credentials belong to the selected provider. */
+export interface VideoConfig {
+    /** Restrict configured-model fallback to this provider route. */
+    provider?: string;
+    /** Model hint after the saved video model selection. */
+    model?: string;
+    /** Deadline covering submission, polling, download, and storage. */
+    timeoutMs?: number;
+    /** Interval between status requests for an accepted video job. */
+    pollIntervalMs?: number;
+    /** Maximum bytes in each provider job response. */
+    maxResponseBytes?: number;
+    /** Maximum downloaded video bytes. */
+    maxVideoBytes?: number;
+    /** Maximum prompt characters. */
+    maxPromptChars?: number;
+}
+/** Loader defaults for video polling and storage. */
+export declare const VideoConfig: z<VideoConfig>;
+/** Register video_generate using the saved video provider and model.
+ * @param ctx - Tool and attachment services, with optional configured LLM routes.
+ * @param config - Loader-validated polling and storage limits.
+ */
+export declare function registerVideos(ctx: Context, config: VideoConfig): void;
+//# sourceMappingURL=video.d.ts.map

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@hydraharness/harness-tool-media",
+  "description": "Image and video generation with durable chat attachments",
+  "hydra": {
+    "plugin": {
+      "application": "Generate images and videos and show them directly in chat."
+    }
+  },
+  "version": "0.1.1-rc.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaiHongPhong1902/Hydra-Harness.git",
+    "directory": "packages/media/tool-media"
+  },
+  "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": "MIT",
+  "peerDependencies": {
+    "@hydraharness/harness-credentials": "^0.1.1-rc.6",
+    "@hydraharness/harness-llm": "^0.1.1-rc.6",
+    "@hydraharness/harness-attachment": "^0.1.1-rc.6",
+    "@hydraharness/harness-tools": "^0.1.1-rc.6",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6",
+    "@hydraharness/cordis": "^4.0.2"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@hydraharness/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@hydraharness/harness-attachment": "^0.1.1-rc.6",
+    "@hydraharness/harness-credentials": "^0.1.1-rc.6",
+    "@hydraharness/harness-tools": "^0.1.1-rc.6",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-attachment-local": "^0.1.1-rc.6",
+    "@hydraharness/harness-llm": "^0.1.1-rc.6",
+    "@hydraharness/harness-system-prompt": "^0.1.1-rc.6",
+    "@hydraharness/harness-credentials-local": "^0.1.1-rc.6",
+    "@hydraharness/harness-session": "^0.1.1-rc.6"
+  }
+}