@inkeep/agents-api 0.0.0-dev-20260121145510

package/dist/domains/run/utils/stream-registry.d.ts

@@ -0,0 +1,22 @@
+import { StreamHelper } from "./stream-helpers.js";
+
+//#region src/domains/run/utils/stream-registry.d.ts
+
+/**
+ * Register a StreamHelper for a specific request ID
+ */
+declare function registerStreamHelper(requestId: string, streamHelper: StreamHelper): void;
+/**
+ * Get a StreamHelper by request ID
+ */
+declare function getStreamHelper(requestId: string): StreamHelper | undefined;
+/**
+ * Unregister a StreamHelper for a specific request ID
+ */
+declare function unregisterStreamHelper(requestId: string): void;
+/**
+ * Get registry size (for debugging)
+ */
+declare function getRegistrySize(): number;
+//#endregion
+export { getRegistrySize, getStreamHelper, registerStreamHelper, unregisterStreamHelper };

package/dist/domains/run/utils/stream-registry.js

@@ -0,0 +1,33 @@
+//#region src/domains/run/utils/stream-registry.ts
+/**
+* Global registry for StreamHelper instances
+* Allows agents to access streamHelper via requestId across A2A boundaries
+*/
+const streamHelperRegistry = /* @__PURE__ */ new Map();
+/**
+* Register a StreamHelper for a specific request ID
+*/
+function registerStreamHelper(requestId, streamHelper) {
+	streamHelperRegistry.set(requestId, streamHelper);
+}
+/**
+* Get a StreamHelper by request ID
+*/
+function getStreamHelper(requestId) {
+	return streamHelperRegistry.get(requestId);
+}
+/**
+* Unregister a StreamHelper for a specific request ID
+*/
+function unregisterStreamHelper(requestId) {
+	streamHelperRegistry.delete(requestId);
+}
+/**
+* Get registry size (for debugging)
+*/
+function getRegistrySize() {
+	return streamHelperRegistry.size;
+}
+
+//#endregion
+export { getRegistrySize, getStreamHelper, registerStreamHelper, unregisterStreamHelper };

package/dist/domains/run/utils/token-estimator.d.ts

@@ -0,0 +1,23 @@
+import * as _inkeep_agents_core3 from "@inkeep/agents-core";
+import { BreakdownComponentDef, ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown } from "@inkeep/agents-core";
+
+//#region src/domains/run/utils/token-estimator.d.ts
+
+/**
+ * Estimates the number of tokens in a text string using character-based approximation.
+ *
+ * @param text - The text to estimate tokens for
+ * @returns Estimated token count (approximately text.length / 4)
+ */
+declare function estimateTokens(text: string | undefined | null): number;
+/**
+ * Result from prompt assembly that includes both the prompt and token breakdown.
+ */
+interface AssembleResult {
+  /** The assembled prompt string */
+  prompt: string;
+  /** Token breakdown for each component */
+  breakdown: _inkeep_agents_core3.ContextBreakdown;
+}
+//#endregion
+export { AssembleResult, type BreakdownComponentDef, type ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown, estimateTokens };

package/dist/domains/run/utils/token-estimator.js

@@ -0,0 +1,17 @@
+import { calculateBreakdownTotal, createEmptyBreakdown } from "@inkeep/agents-core";
+
+//#region src/domains/run/utils/token-estimator.ts
+const CHARS_PER_TOKEN = 4;
+/**
+* Estimates the number of tokens in a text string using character-based approximation.
+*
+* @param text - The text to estimate tokens for
+* @returns Estimated token count (approximately text.length / 4)
+*/
+function estimateTokens(text) {
+	if (!text) return 0;
+	return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+
+//#endregion
+export { calculateBreakdownTotal, createEmptyBreakdown, estimateTokens };

package/dist/domains/run/utils/tracer.d.ts

@@ -0,0 +1,7 @@
+import { setSpanWithError } from "@inkeep/agents-core";
+import * as _opentelemetry_api0 from "@opentelemetry/api";
+
+//#region src/domains/run/utils/tracer.d.ts
+declare const tracer: _opentelemetry_api0.Tracer;
+//#endregion
+export { setSpanWithError, tracer };

package/dist/domains/run/utils/tracer.js

@@ -0,0 +1,7 @@
+import { getTracer, setSpanWithError } from "@inkeep/agents-core";
+
+//#region src/domains/run/utils/tracer.ts
+const tracer = getTracer("agents-run-api");
+
+//#endregion
+export { setSpanWithError, tracer };

package/dist/env.d.ts

@@ -0,0 +1,89 @@
+import { z } from "@hono/zod-openapi";
+
+//#region src/env.d.ts
+declare const envSchema: z.ZodObject<{
+  NODE_ENV: z.ZodDefault<z.ZodEnum<{
+    development: "development";
+    production: "production";
+    test: "test";
+  }>>;
+  ENVIRONMENT: z.ZodDefault<z.ZodEnum<{
+    development: "development";
+    production: "production";
+    test: "test";
+    pentest: "pentest";
+  }>>;
+  LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+    trace: "trace";
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    error: "error";
+  }>>;
+  INKEEP_AGENTS_MANAGE_DATABASE_URL: z.ZodString;
+  INKEEP_AGENTS_RUN_DATABASE_URL: z.ZodString;
+  INKEEP_AGENTS_MANAGE_UI_URL: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_API_URL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  BETTER_AUTH_SECRET: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_MANAGE_UI_USERNAME: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_MANAGE_UI_PASSWORD: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_API_BYPASS_SECRET: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_RUN_API_BYPASS_SECRET: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_EVAL_API_BYPASS_SECRET: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY: z.ZodOptional<z.ZodString>;
+  INKEEP_AGENTS_TEMP_JWT_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
+  NANGO_SERVER_URL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  NANGO_SECRET_KEY: z.ZodOptional<z.ZodString>;
+  OTEL_BSP_SCHEDULE_DELAY: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  OTEL_BSP_MAX_EXPORT_BATCH_SIZE: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  DISABLE_AUTH: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodString>>, z.ZodTransform<boolean, string>>;
+  TENANT_ID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  SIGNOZ_URL: z.ZodOptional<z.ZodString>;
+  SIGNOZ_API_KEY: z.ZodOptional<z.ZodString>;
+  PUBLIC_SIGNOZ_URL: z.ZodOptional<z.ZodString>;
+  ANTHROPIC_API_KEY: z.ZodString;
+  OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
+  GOOGLE_GENERATIVE_AI_API_KEY: z.ZodOptional<z.ZodString>;
+  WORKFLOW_TARGET_WORLD: z.ZodOptional<z.ZodString>;
+  WORKFLOW_POSTGRES_URL: z.ZodOptional<z.ZodString>;
+  WORKFLOW_POSTGRES_JOB_PREFIX: z.ZodOptional<z.ZodString>;
+  WORKFLOW_POSTGRES_WORKER_CONCURRENCY: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const env: {
+  NODE_ENV: "development" | "production" | "test";
+  ENVIRONMENT: "development" | "production" | "test" | "pentest";
+  LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error";
+  INKEEP_AGENTS_MANAGE_DATABASE_URL: string;
+  INKEEP_AGENTS_RUN_DATABASE_URL: string;
+  INKEEP_AGENTS_API_URL: string;
+  NANGO_SERVER_URL: string;
+  OTEL_BSP_SCHEDULE_DELAY: number;
+  OTEL_BSP_MAX_EXPORT_BATCH_SIZE: number;
+  DISABLE_AUTH: boolean;
+  TENANT_ID: string;
+  ANTHROPIC_API_KEY: string;
+  INKEEP_AGENTS_MANAGE_UI_URL?: string | undefined;
+  BETTER_AUTH_SECRET?: string | undefined;
+  INKEEP_AGENTS_MANAGE_UI_USERNAME?: string | undefined;
+  INKEEP_AGENTS_MANAGE_UI_PASSWORD?: string | undefined;
+  INKEEP_AGENTS_API_BYPASS_SECRET?: string | undefined;
+  INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET?: string | undefined;
+  INKEEP_AGENTS_RUN_API_BYPASS_SECRET?: string | undefined;
+  INKEEP_AGENTS_EVAL_API_BYPASS_SECRET?: string | undefined;
+  INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY?: string | undefined;
+  INKEEP_AGENTS_TEMP_JWT_PRIVATE_KEY?: string | undefined;
+  NANGO_SECRET_KEY?: string | undefined;
+  SIGNOZ_URL?: string | undefined;
+  SIGNOZ_API_KEY?: string | undefined;
+  PUBLIC_SIGNOZ_URL?: string | undefined;
+  OPENAI_API_KEY?: string | undefined;
+  GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
+  WORKFLOW_TARGET_WORLD?: string | undefined;
+  WORKFLOW_POSTGRES_URL?: string | undefined;
+  WORKFLOW_POSTGRES_JOB_PREFIX?: string | undefined;
+  WORKFLOW_POSTGRES_WORKER_CONCURRENCY?: string | undefined;
+};
+type Env = z.infer<typeof envSchema>;
+//#endregion
+export { Env, env };

package/dist/env.js

@@ -0,0 +1,69 @@
+import { z } from "@hono/zod-openapi";
+import { loadEnvironmentFiles } from "@inkeep/agents-core";
+
+//#region src/env.ts
+loadEnvironmentFiles();
+const envSchema = z.object({
+	NODE_ENV: z.enum([
+		"development",
+		"production",
+		"test"
+	]).default("development"),
+	ENVIRONMENT: z.enum([
+		"development",
+		"production",
+		"pentest",
+		"test"
+	]).default("development"),
+	LOG_LEVEL: z.enum([
+		"trace",
+		"debug",
+		"info",
+		"warn",
+		"error"
+	]).default("info"),
+	INKEEP_AGENTS_MANAGE_DATABASE_URL: z.string(),
+	INKEEP_AGENTS_RUN_DATABASE_URL: z.string(),
+	INKEEP_AGENTS_MANAGE_UI_URL: z.string().optional(),
+	INKEEP_AGENTS_API_URL: z.string().optional().default("http://localhost:3002"),
+	BETTER_AUTH_SECRET: z.string().optional(),
+	INKEEP_AGENTS_MANAGE_UI_USERNAME: z.string().optional().refine((val) => !val || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(val), { message: "Invalid email address" }),
+	INKEEP_AGENTS_MANAGE_UI_PASSWORD: z.string().optional().refine((val) => !val || val.length >= 8, { message: "Password must be at least 8 characters" }),
+	INKEEP_AGENTS_API_BYPASS_SECRET: z.string().optional(),
+	INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET: z.string().optional(),
+	INKEEP_AGENTS_RUN_API_BYPASS_SECRET: z.string().optional(),
+	INKEEP_AGENTS_EVAL_API_BYPASS_SECRET: z.string().optional(),
+	INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY: z.string().optional(),
+	INKEEP_AGENTS_TEMP_JWT_PRIVATE_KEY: z.string().optional(),
+	NANGO_SERVER_URL: z.string().optional().default("https://api.nango.dev"),
+	NANGO_SECRET_KEY: z.string().optional(),
+	OTEL_BSP_SCHEDULE_DELAY: z.coerce.number().optional().default(500),
+	OTEL_BSP_MAX_EXPORT_BATCH_SIZE: z.coerce.number().optional().default(64),
+	DISABLE_AUTH: z.string().optional().default("false").transform((val) => val === "true"),
+	TENANT_ID: z.string().optional().default("default"),
+	SIGNOZ_URL: z.string().optional(),
+	SIGNOZ_API_KEY: z.string().optional(),
+	PUBLIC_SIGNOZ_URL: z.string().optional(),
+	ANTHROPIC_API_KEY: z.string(),
+	OPENAI_API_KEY: z.string().optional(),
+	GOOGLE_GENERATIVE_AI_API_KEY: z.string().optional(),
+	WORKFLOW_TARGET_WORLD: z.string().optional(),
+	WORKFLOW_POSTGRES_URL: z.string().optional(),
+	WORKFLOW_POSTGRES_JOB_PREFIX: z.string().optional(),
+	WORKFLOW_POSTGRES_WORKER_CONCURRENCY: z.string().optional()
+});
+const parseEnv = () => {
+	try {
+		return envSchema.parse(process.env);
+	} catch (error) {
+		if (error instanceof z.ZodError) {
+			const missingVars = error.issues.map((issue) => issue.path.join("."));
+			throw new Error(`❌ Invalid environment variables: ${missingVars.join(", ")}\n${error.message}`);
+		}
+		throw error;
+	}
+};
+const env = parseEnv();
+
+//#endregion
+export { env };