@zuplo/runtime 6.60.26 → 6.60.28

package/out/types/index.d.ts

@@ -294,6 +294,42 @@ export declare function AIGatewayUsageTrackerPolicy(
   _policyName: string
 ): Promise<Response>;
 
+/**
+ * Akamai AI Firewall Inbound Policy
+ * @title Akamai AI Firewall
+ * @hidden
+ *
+ * This policy integrates with Akamai's AI Firewall service to detect
+ * and block malicious AI inputs and outputs. It's self-contained and
+ * handles both streaming and non-streaming responses.
+ *
+ * For streaming responses, it uses a transform stream that can block
+ * content mid-stream if harmful content is detected.
+ *
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @param options - The policy options set in policies.json
+ * @param policyName - The name of the policy as set in policies.json
+ * @returns A Request or a Response
+ */
+export declare function AkamaiAIFirewallInboundPolicy(
+  request: ZuploRequest,
+  context: ZuploContext,
+  _options: AkamaiAIFirewallPolicyOptions,
+  _policyName: string
+): Promise<ZuploRequest | Response>;
+
+/**
+ * The options for the Akamai AI Firewall policy.
+ * @public
+ */
+export declare interface AkamaiAIFirewallPolicyOptions {
+  configurationId: ConfigurationID;
+  "api-key": APIKey;
+  applicationId?: ApplicationID;
+  streamingAccumulation?: StreamingAccumulationSettings;
+}
+
 /**
  * Entry format for Akamai API Security logger
  * @public
@@ -500,6 +536,12 @@ export declare interface ApiAuthKeyInboundPolicyOptions {
   allowUnauthenticatedRequests?: boolean;
 }
 
+/**
+ * The API key for the AI Firewall.
+ * @public
+ */
+declare type APIKey = string;
+
 /**
  * Authenticates requests based on API Keys using Zuplo's built-in API key management.
  * This policy validates API keys against Zuplo's key storage, caches results for performance,
@@ -644,6 +686,12 @@ declare interface APITokenCredentialConfig {
   headerValuePrefix?: string;
 }
 
+/**
+ * The application ID to identify this usage of the AI Firewall (optional).
+ * @public
+ */
+declare type ApplicationID = string;
+
 /**
  * A list of attributes that will be included in the authorization request.
  * @public
@@ -1690,6 +1738,12 @@ export declare interface ChangeMethodInboundPolicyOptions {
   method: string;
 }
 
+/**
+ * Time interval in milliseconds for periodic checks (alternative to chunk count).
+ * @public
+ */
+declare type CheckIntervalMs = number;
+
 /**
  * Removes all headers from the incoming request except for those in the exclude list.
  *
@@ -2104,6 +2158,12 @@ export declare class ConfigurationError extends RuntimeError {
   constructor(message: string, options?: ErrorOptions);
 }
 
+/**
+ * The configuration ID of the AI Firewall.
+ * @public
+ */
+declare type ConfigurationID = string;
+
 /* Excluded from this release type: ContentTypes */
 
 /**
@@ -2513,6 +2573,12 @@ export declare class DynatraceMetricsPlugin extends MetricsPlugin {
   static setContext(context: ZuploContext, data: DynatraceMetricsContext): void;
 }
 
+/**
+ * Enable accumulation and validation of streaming responses.
+ * @public
+ */
+declare type EnableStreamingAccumulation = boolean;
+
 /**
  * @beta
  * Object exposing environment variables
@@ -2530,6 +2596,12 @@ export declare interface ErrorHandler {
   ): Response | Promise<Response>;
 }
 
+/**
+ * Number of SSE events to accumulate before checking with Akamai (default: 5).
+ * @public
+ */
+declare type EventsInterval = number;
+
 declare const EventType: {
   readonly MCP_TOOL_USAGE: "mcp_tool_usage";
   readonly AI_GATEWAY_COST_SUM: "ai_gateway_cost_sum";
@@ -8302,6 +8374,16 @@ export declare class SplunkLoggingPlugin extends LogPlugin {
 
 /* Excluded from this release type: StandardEnv */
 
+/**
+ * Configuration for accumulating and validating streaming responses.
+ * @public
+ */
+declare interface StreamingAccumulationSettings {
+  enabled?: EnableStreamingAccumulation;
+  eventsInterval?: EventsInterval;
+  checkIntervalMs?: CheckIntervalMs;
+}
+
 /**
  * A specialized zone cache for storing and retrieving ReadableStreams.
  * Unlike regular ZoneCache which serializes to JSON, this cache stores raw stream data,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "6.60.26",
+  "version": "6.60.28",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {