@schlenkr/ragents 0.1.5 → 0.1.6

package/packages/ai/src/providers/openrouter.models.ts

@@ -1081,6 +1081,20 @@ export const OPENROUTER_MODELS = {
 		contextWindow: 1048576,
 		maxTokens: 943718,
 	} satisfies Model<"openai-completions">,
+	"deepseek/deepseek-v4.1-flash": {
+		id: "deepseek/deepseek-v4.1-flash",
+		name: "DeepSeek: DeepSeek V4.1 Flash",
+		api: "openai-completions",
+		provider: "openrouter",
+		baseUrl: "https://openrouter.ai/api/v1",
+		compat: {"supportsDeveloperRole":false,"thinkingFormat":"openrouter","requiresReasoningContentOnAssistantMessages":true},
+		reasoning: true,
+		thinkingLevelMap: {"off":"none","minimal":null,"low":"low","medium":null,"high":"high","xhigh":null,"max":"max"},
+		input: ["text", "image"],
+		cost: {"input":0.15,"output":0.6,"cacheRead":0.003,"cacheWrite":0},
+		contextWindow: 1048576,
+		maxTokens: 393216,
+	} satisfies Model<"openai-completions">,
 	"dots-studio/dots-3-note-preview:free": {
 		id: "dots-studio/dots-3-note-preview:free",
 		name: "Dots Studio: Dots3-Note Preview (free)",

package/packages/ai/src/types.ts

@@ -8,18 +8,10 @@ export type KnownApi = "openai-completions";
 
 export type Api = KnownApi | (string & {});
 
-export type KnownImagesApi = "openrouter-images";
-
-export type ImagesApi = KnownImagesApi | (string & {});
-
 export type KnownProvider = "openrouter";
 
 export type ProviderId = KnownProvider | string;
 
-export type KnownImagesProvider = "openrouter";
-
-export type ImagesProviderId = KnownImagesProvider | string;
-
 export type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 export type ModelThinkingLevel = "off" | ThinkingLevel;
 export type ThinkingLevelMap = Partial<Record<ModelThinkingLevel, string | null>>;
@@ -166,68 +158,6 @@ export interface ProviderStreams {
 	streamSimple(model: Model<Api>, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;
 }
 
-/**
- * The uniform contract of an image-generation API implementation module:
- * every image API module under `src/api/` exports exactly `generateImages`,
- * so the module itself satisfies this interface. Lazy wrappers and image
- * provider factories pass these around as values.
- */
-export interface ProviderImages {
-	generateImages(
-		model: ImagesModel<ImagesApi>,
-		context: ImagesContext,
-		options?: ImagesOptions,
-	): Promise<AssistantImages>;
-}
-
-export interface ImagesOptions {
-	signal?: AbortSignal;
-	apiKey?: string;
-	/**
-	 * Provider-scoped environment values. These take precedence over process.env for
-	 * provider configuration such as endpoint placeholders and proxy variables.
-	 */
-	env?: ProviderEnv;
-	/**
-	 * Optional callback for inspecting or replacing provider payloads before sending.
-	 * Return undefined to keep the payload unchanged.
-	 */
-	onPayload?: (payload: unknown, model: ImagesModel<ImagesApi>) => unknown | undefined | Promise<unknown | undefined>;
-	/**
-	 * Optional callback invoked after an HTTP response is received.
-	 */
-	onResponse?: (response: ProviderResponse, model: ImagesModel<ImagesApi>) => void | Promise<void>;
-	/**
-	 * Optional custom HTTP headers to include in API requests.
-	 * Merged with provider defaults; can override default headers.
-	 * A null value suppresses a provider/API default header with the same name.
-	 */
-	headers?: ProviderHeaders;
-	/**
-	 * HTTP request timeout in milliseconds for providers/SDKs that support it.
-	 */
-	timeoutMs?: number;
-	/**
-	 * Maximum retry attempts for providers/SDKs that support client-side retries.
-	 */
-	maxRetries?: number;
-	/**
-	 * Maximum delay in milliseconds to wait for a retry when the server requests a long wait.
-	 * If the server's requested delay exceeds this value, the request fails immediately
-	 * with an error containing the requested delay, allowing higher-level retry logic
-	 * to handle it with user visibility.
-	 * Default: 60000 (60 seconds). Set to 0 to disable the cap.
-	 */
-	maxRetryDelayMs?: number;
-	/**
-	 * Optional metadata to include in API requests.
-	 * Providers extract the fields they understand and ignore the rest.
-	 */
-	metadata?: Record<string, unknown>;
-}
-
-export type ProviderImagesOptions = ImagesOptions & Record<string, unknown>;
-
 // Unified options with reasoning passed to streamSimple() and completeSimple()
 export interface SimpleStreamOptions extends StreamOptions {
 	reasoning?: ThinkingLevel;
@@ -249,12 +179,6 @@ export type StreamFunction<TApi extends Api = Api, TOptions extends StreamOption
 	options?: TOptions,
 ) => AssistantMessageEventStream;
 
-export type ImagesFunction<TApi extends ImagesApi = ImagesApi, TOptions extends ImagesOptions = ImagesOptions> = (
-	model: ImagesModel<TApi>,
-	context: ImagesContext,
-	options?: TOptions,
-) => Promise<AssistantImages>;
-
 export interface TextSignatureV1 {
 	v: 1;
 	id: string;
@@ -372,27 +296,6 @@ export interface ToolResultMessage<TDetails = any> {
 
 export type Message = UserMessage | AssistantMessage | ToolResultMessage;
 
-export type ImagesInputContent = TextContent | ImageContent;
-export type ImagesOutputContent = TextContent | ImageContent;
-
-export interface ImagesContext {
-	input: ImagesInputContent[];
-}
-
-export type ImagesStopReason = "stop" | "error" | "aborted";
-
-export interface AssistantImages {
-	api: ImagesApi;
-	provider: ImagesProviderId;
-	model: string;
-	output: ImagesOutputContent[];
-	responseId?: string;
-	usage?: Usage;
-	stopReason: ImagesStopReason;
-	errorMessage?: string;
-	timestamp: number; // Unix timestamp in milliseconds
-}
-
 import type { TSchema } from "typebox";
 
 export interface Tool<TParameters extends TSchema = TSchema> {
@@ -683,10 +586,3 @@ export interface Model<TApi extends Api> {
 				? AnthropicMessagesCompat
 				: never;
 }
-
-export interface ImagesModel<TApi extends ImagesApi>
-	extends Omit<Model<Api>, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
-	api: TApi;
-	provider: ImagesProviderId;
-	output: ("text" | "image")[];
-}

package/packages/ai/src/utils/diagnostics.ts

@@ -11,35 +11,3 @@ export interface AssistantMessageDiagnostic {
 	error?: DiagnosticErrorInfo;
 	details?: Record<string, unknown>;
 }
-
-export function formatThrownValue(value: unknown): string {
-	if (value instanceof Error) return value.message || value.name;
-	if (typeof value === "string") return value;
-	return String(value);
-}
-
-export function extractDiagnosticError(error: unknown): DiagnosticErrorInfo {
-	if (!(error instanceof Error)) return { name: "ThrownValue", message: formatThrownValue(error) };
-	const code = (error as Error & { code?: unknown }).code;
-	return {
-		name: error.name || undefined,
-		message: error.message || error.name,
-		stack: error.stack,
-		code: typeof code === "string" || typeof code === "number" ? code : undefined,
-	};
-}
-
-export function createAssistantMessageDiagnostic(
-	type: string,
-	error: unknown,
-	details?: Record<string, unknown>,
-): AssistantMessageDiagnostic {
-	return { type, timestamp: Date.now(), error: extractDiagnosticError(error), details };
-}
-
-export function appendAssistantMessageDiagnostic<T extends { diagnostics?: AssistantMessageDiagnostic[] }>(
-	message: T,
-	diagnostic: AssistantMessageDiagnostic,
-): void {
-	message.diagnostics = [...(message.diagnostics ?? []), diagnostic];
-}

package/packages/ai/src/utils/headers.ts

@@ -1,5 +1,3 @@
-import type { ProviderHeaders } from "../types.ts";
-
 export function headersToRecord(headers: Headers): Record<string, string> {
 	const result: Record<string, string> = {};
 	for (const [key, value] of headers.entries()) {
@@ -7,12 +5,3 @@ export function headersToRecord(headers: Headers): Record<string, string> {
 	}
 	return result;
 }
-
-export function providerHeadersToRecord(headers: ProviderHeaders | undefined): Record<string, string> | undefined {
-	if (!headers) return undefined;
-	const result: Record<string, string> = {};
-	for (const [key, value] of Object.entries(headers)) {
-		if (value !== null) result[key] = value;
-	}
-	return Object.keys(result).length > 0 ? result : undefined;
-}

package/packages/ai/src/utils/overflow.ts

@@ -156,10 +156,3 @@ export function isContextOverflow(message: AssistantMessage, contextWindow?: num
 
 	return false;
 }
-
-/**
- * Get the overflow patterns for testing purposes.
- */
-export function getOverflowPatterns(): RegExp[] {
-	return [...OVERFLOW_PATTERNS];
-}

package/packages/ai/src/utils/validation.ts

@@ -327,21 +327,6 @@ function formatValidationErrors(errors: TLocalizedValidationError[], args: unkno
 	});
 }
 
-/**
- * Finds a tool by name and validates the tool call arguments against its TypeBox schema
- * @param tools Array of tool definitions
- * @param toolCall The tool call from the LLM
- * @returns The validated arguments
- * @throws Error if tool is not found or validation fails
- */
-export function validateToolCall(tools: Tool[], toolCall: ToolCall): any {
-	const tool = tools.find((t) => t.name === toolCall.name);
-	if (!tool) {
-		throw new Error(`Tool "${toolCall.name}" not found`);
-	}
-	return validateToolArguments(tool, toolCall);
-}
-
 /**
  * Validates tool call arguments against the tool's TypeBox schema
  * @param tool The tool definition with TypeBox schema

package/packages/ragents/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@aicontainer/ragents",
+  "name": "@ragents/engine",
   "version": "0.1.0",
   "private": true,
   "type": "module",
@@ -17,12 +17,9 @@
     "typecheck": "tsc --noEmit",
     "check": "pnpm run typecheck && pnpm test"
   },
-  "devDependencies": {
-    "@aicontainer/agent-core": "workspace:*",
-    "@aicontainer/ai": "workspace:*"
-  },
   "dependencies": {
-    "@aicontainer/agent": "workspace:*",
+    "@ragents/agent": "workspace:*",
+    "@ragents/ai": "workspace:*",
     "@types/node": "^24.10.0",
     "typebox": "1.1.38",
     "typescript": "^5.9.0",

package/packages/ragents/src/access.ts

@@ -22,12 +22,13 @@ export interface AccessContext extends AccessSnapshot {
 
 export const builtinPermissions = [
   { id: "runs.read", description: "Runs, Chats, Journale und Arbeitsbereiche ansehen." },
+  { id: "runs.read.all", description: "Die Runs aller Benutzer sehen und bedienen, nicht nur die eigenen; einen Run, den nur sein Eigentümer bedient, nur im Journal lesen und stoppen, ohne seinen Arbeitsbereich." },
   { id: "runs.write", description: "Vorhandene Runs steuern, Nachrichten senden, freigegebene Setups starten und App-Aktionen ausführen." },
   { id: "runs.create", description: "Freie Runs erstellen, Startoptionen wählen und Aufträge vorbereiten." },
   { id: "runs.inspect", description: "Modelle, technische Laufdetails, Journale und Programmquellen ansehen." },
   { id: "runs.trace", description: "Denk- und Werkzeugschritte im Chat mit Inhalt sehen und ihren Detailgrad wählen." },
   { id: "runs.delete", description: "Runs und ihre gespeicherten Daten löschen." },
-  { id: "settings.read", description: "Profil, Konfiguration und Erweiterungen ansehen." },
+  { id: "settings.read", description: "Profil, Konfiguration und Plugins ansehen." },
   { id: "settings.write", description: "Einstellungen und externen Zugang ändern." },
   { id: "models.use", description: "Modelle über das Modell-Relay dieses Servers aufrufen." },
   { id: "profile.fetch", description: "Das Client-Profil dieses Servers beschreiben und herunterladen." },

package/packages/ragents/src/agents/actor-input.ts

@@ -49,6 +49,10 @@ const eventPayloads = {
         turnId: Type.String({ description: "ID des gestarteten Turns" }),
         inputId: Type.String(),
     }),
+    "turn.input-steered": payloadOf<"turn.input-steered">({
+        turnId: Type.String({ description: "Laufender Turn, in den der Input eingespeist wurde" }),
+        inputId: Type.String(),
+    }),
     "turn.finished": payloadOf<"turn.finished">({
         turnId: Type.String({ description: "ID des beendeten Turns" }),
         outcome: Type.String(),
@@ -56,11 +60,13 @@ const eventPayloads = {
     }),
     "turn.interrupted": payloadOf<"turn.interrupted">({
         turnId: Type.String({ description: "ID des unterbrochenen Turns" }),
-        reason: Type.String(),
     }),
     "model.output.completed": payloadOf<"model.output.completed">({
         turnId: Type.String({ description: "Turn, zu dem die Ausgabe gehört" }),
     }),
+    "model.output.interrupted": payloadOf<"model.output.interrupted">({
+        turnId: Type.String({ description: "Turn, zu dem die Ausgabe gehört" }),
+    }),
     "model.reasoning.completed": payloadOf<"model.reasoning.completed">({
         turnId: Type.String({ description: "Turn, zu dem die Ausgabe gehört" }),
     }),
@@ -94,11 +100,9 @@ const eventPayloads = {
     }),
     "actor.stopped": payloadOf<"actor.stopped">({
         actorId: Type.String({ description: "ID des gestoppten Actors" }),
-        reason: Type.String(),
     }),
     "actor.restarted": payloadOf<"actor.restarted">({
         actorId: Type.String({ description: "ID des neu gestarteten Actors" }),
-        reason: Type.String(),
     }),
     "subscription.created": payloadOf<"subscription.created">({
         subscriptionId: Type.String({ description: "ID der neuen Subscription" }),
@@ -106,7 +110,6 @@ const eventPayloads = {
     }),
     "subscription.removed": payloadOf<"subscription.removed">({
         subscriptionId: Type.String({ description: "ID der entfernten Subscription" }),
-        reason: Type.String(),
     }),
     "subscription.failed": payloadOf<"subscription.failed">({
         subscriptionId: Type.String({ description: "ID der gescheiterten Subscription" }),
@@ -115,7 +118,6 @@ const eventPayloads = {
     }),
     "action.proposed": payloadOf<"action.proposed">({
         actionId: Type.String({ description: "ID der vorgeschlagenen Aktion" }),
-        title: Type.String(),
     }),
     "action.resolved": payloadOf<"action.resolved">({
         actionId: Type.String({ description: "ID der aufgelösten Aktion" }),
@@ -124,8 +126,6 @@ const eventPayloads = {
     "artifact.published": payloadOf<"artifact.published">({
         artifact: Type.Object({
             id: Type.String({ description: "ID des Artefakts; artifact_read liest es damit" }),
-            title: Type.String(),
-            mediaType: Type.String(),
         }, { additionalProperties: false }),
     }),
     "plugin.state-replaced": payloadOf<"plugin.state-replaced">({
@@ -136,17 +136,13 @@ const eventPayloads = {
     }),
 } satisfies Record<EventType, TSchema>;
 
-export const eventResultSchema: TSchema = Type.Array(
-    Type.Union(Object.entries(eventPayloads).map(([type, payload]) => Type.Object({
-        type: Type.Literal(type),
-        payload,
-    }, { additionalProperties: false }))),
-    {
-        description:
-            "Die Journal-Events dieses Aufrufs. Die payload nennt die Kennungen des Ergebnisses; "
-            + "Eingaben und Hashes wiederholt sie nicht.",
-    },
-);
+/** Die Journal-Events eines Aufrufs, eingegrenzt auf die Typen, die er tatsächlich erzeugt. */
+export const eventResultSchemaOf = (...types: readonly EventType[]): TSchema => {
+    const variants = types.map((type) => Type.Object({ type: Type.Literal(type), payload: eventPayloads[type] }, { additionalProperties: false }));
+    return Type.Array(variants.length === 1 ? variants[0]! : Type.Union(variants), {
+        description: "Die Journal-Events dieses Aufrufs. Die payload nennt die Kennungen des Ergebnisses; Eingaben und Hashes wiederholt sie nicht.",
+    });
+};
 
 const pickedBySchema = (schema: TSchema, value: JsonValue): JsonValue => {
     const properties = (schema as { properties?: Record<string, TSchema> }).properties;

package/packages/ragents/src/agents/catalog.ts

@@ -200,16 +200,16 @@ export const resolveExecution = (
 };
 
 export class StaticModelCatalog implements ModelCatalog {
-    readonly #models: readonly CatalogModel[];
+    readonly modelList: readonly CatalogModel[];
     readonly #profiles: readonly AgentProfile[];
 
     constructor(models: readonly CatalogModel[] = [], profiles: readonly AgentProfile[] = defaultProfiles) {
-        this.#models = models;
+        this.modelList = models;
         this.#profiles = profiles;
     }
 
     async models() {
-        return this.#models;
+        return this.modelList;
     }
 
     profiles() {

package/packages/ragents/src/agents/plugins.ts

@@ -22,8 +22,6 @@ export type ToolContributor = {
     tools: (context: PluginContext) => readonly RunFunction[] | Promise<readonly RunFunction[]>;
 };
 
-export type AgentToolPlugin = ToolContributor;
-
 export interface ToolProvider {
     resolve(context: PluginContext, onUnavailable?: (tool: RunFunction) => void): Promise<RunFunction[]>;
 }
@@ -126,5 +124,3 @@ export class ToolRegistry implements ToolProvider {
         }
     }
 }
-
-export const emptyRegistry = () => new ToolRegistry();