agentkernel 0.5.0__tar.gz → 0.6.0__tar.gz

{agentkernel-0.5.0 → agentkernel-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentkernel
-Version: 0.5.0
+Version: 0.6.0
 Summary: Agent Kernel - Unified AI Agents Runtime
 Author: Yaala Labs
 Author-email: Yaala Labs <agentkernel@yaalalabs.com>

{agentkernel-0.5.0 → agentkernel-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "agentkernel"
-version = "0.5.0"
+version = "0.6.0"
 description = "Agent Kernel - Unified AI Agents Runtime"
 readme = "README.md"
 requires-python = ">=3.12,<3.14"

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/core/hooks.py

@@ -23,7 +23,7 @@ class PreHook(ABC):
         Hook method called before an agent starts executing a prompt. These hooks can modify the prompt or halt execution.
         Some use cases:
           - RAG context injection
-          - Prompt validation like input guard rails
+          - Prompt validation like input guardrails
           - Logging or analytics
 
         :param: session (Session): The session instance.

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-add-capabilities/SKILL.md

@@ -9,7 +9,7 @@ description: >
 license: Apache-2.0
 metadata:
   author: yaalalabs
-  version: "0.5.0"
+  version: "0.6.0"
   category: user
 ---
 
@@ -51,7 +51,7 @@ Which capability would you like to add?
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api]>=0.5.0",
+    "agentkernel[openai,api]>=0.6.0",
     # OpenAI guardrails use the openai extra — already included if using OpenAI framework
 ]
 ```
@@ -105,7 +105,7 @@ guardrail:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,aws]>=0.5.0",
+    "agentkernel[openai,api,aws]>=0.6.0",
 ]
 ```
 
@@ -131,7 +131,7 @@ guardrail:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,walledai]>=0.5.0",
+    "agentkernel[openai,api,walledai]>=0.6.0",
 ]
 ```
 
@@ -168,7 +168,7 @@ export WALLED_API_KEY="your-walledai-api-key"
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,langfuse]>=0.5.0",
+    "agentkernel[openai,api,langfuse]>=0.6.0",
 ]
 ```
 
@@ -193,7 +193,7 @@ export LANGFUSE_HOST="https://cloud.langfuse.com"   # or self-hosted URL
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,openllmetry]>=0.5.0",
+    "agentkernel[openai,api,openllmetry]>=0.6.0",
 ]
 ```
 
@@ -217,7 +217,7 @@ trace:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,redis]>=0.5.0",
+    "agentkernel[openai,api,redis]>=0.6.0",
 ]
 ```
 
@@ -237,7 +237,7 @@ session:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,aws]>=0.5.0",
+    "agentkernel[openai,api,aws]>=0.6.0",
 ]
 ```
 
@@ -259,7 +259,7 @@ session:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,azure]>=0.5.0",
+    "agentkernel[openai,api,azure]>=0.6.0",
 ]
 ```
 
@@ -281,7 +281,7 @@ session:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,gcp]>=0.5.0",
+    "agentkernel[openai,api,gcp]>=0.6.0",
 ]
 ```
 
@@ -314,9 +314,9 @@ Add durable knowledge tools that your agents can query and update across session
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,chromadb]>=0.5.0",  # for Chroma
-  # or "agentkernel[openai,api,neo4j]>=0.5.0"
-  # or "agentkernel[openai,api,trino]>=0.5.0"
+  "agentkernel[openai,api,chromadb]>=0.6.0",  # for Chroma
+  # or "agentkernel[openai,api,neo4j]>=0.6.0"
+  # or "agentkernel[openai,api,trino]>=0.6.0"
 ]
 ```
 
@@ -397,7 +397,7 @@ Expose your agents as MCP (Model Context Protocol) tools so other AI systems can
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,mcp]>=0.5.0",
+    "agentkernel[openai,api,mcp]>=0.6.0",
 ]
 ```
 
@@ -423,7 +423,7 @@ Enable Agent-to-Agent communication via Google's A2A protocol.
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,a2a]>=0.5.0",
+    "agentkernel[openai,api,a2a]>=0.6.0",
 ]
 ```
 
@@ -523,7 +523,7 @@ Enable image and file processing in your agents.
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,multimodal]>=0.5.0",
+    "agentkernel[openai,api,multimodal]>=0.6.0",
 ]
 ```
 
@@ -548,7 +548,7 @@ multimodal:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,redis,multimodal]>=0.5.0",
+    "agentkernel[openai,api,redis,multimodal]>=0.6.0",
 ]
 ```
 
@@ -571,7 +571,7 @@ multimodal:
 1. Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,aws,multimodal]>=0.5.0",
+    "agentkernel[openai,api,aws,multimodal]>=0.6.0",
 ]
 ```
 

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-add-capabilities/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-add-capabilities",
   "description": "Evaluations for the ak-add-capabilities (guardrails, tracing, sessions, knowledge base, MCP, A2A, hooks, multimodal) skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "cap-guardrail-openai",

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-add-integration/SKILL.md

@@ -49,7 +49,7 @@ Which messaging platform would you like to integrate?
 Add `slack` to the extras:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,slack]>=0.5.0",
+    "agentkernel[openai,api,slack]>=0.6.0",
 ]
 ```
 
@@ -94,7 +94,7 @@ export SLACK_SIGNING_SECRET="..."          # App signing secret
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,whatsapp]>=0.5.0",
+    "agentkernel[openai,api,whatsapp]>=0.6.0",
 ]
 ```
 
@@ -140,7 +140,7 @@ export AK_WHATSAPP__APP_SECRET="..."           # App secret for signature verifi
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,messenger]>=0.5.0",
+    "agentkernel[openai,api,messenger]>=0.6.0",
 ]
 ```
 
@@ -183,7 +183,7 @@ export AK_MESSENGER__APP_SECRET="..."
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,instagram]>=0.5.0",
+    "agentkernel[openai,api,instagram]>=0.6.0",
 ]
 ```
 
@@ -220,7 +220,7 @@ export AK_INSTAGRAM__INSTAGRAM_ACCOUNT_ID="..."
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,telegram]>=0.5.0",
+    "agentkernel[openai,api,telegram]>=0.6.0",
 ]
 ```
 
@@ -261,7 +261,7 @@ export AK_TELEGRAM__WEBHOOK_SECRET="..."       # Your webhook secret
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,gmail]>=0.5.0",
+    "agentkernel[openai,api,gmail]>=0.6.0",
 ]
 ```
 
@@ -299,7 +299,7 @@ if __name__ == "__main__":
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,teams]>=0.5.0",
+    "agentkernel[openai,api,teams]>=0.6.0",
 ]
 ```
 
@@ -359,7 +359,7 @@ if __name__ == "__main__":
 Update `pyproject.toml`:
 ```toml
 dependencies = [
-    "agentkernel[openai,api,slack,whatsapp,telegram]>=0.5.0",
+    "agentkernel[openai,api,slack,whatsapp,telegram]>=0.6.0",
 ]
 ```
 

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-add-integration/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-add-integration",
   "description": "Evaluations for the ak-add-integration (messaging platform) skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "int-slack",

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-build/SKILL.md

@@ -354,7 +354,7 @@ If the new tool or agent requires additional packages, update `pyproject.toml`:
 
 ```toml
 dependencies = [
-    "agentkernel[openai,api,redis]>=0.5.0",
+    "agentkernel[openai,api,redis]>=0.6.0",
     "httpx>=0.27.0",        # Add any new deps for your tool
 ]
 ```

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-build/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-build",
   "description": "Evaluations for the ak-build (add tools, agents, handoffs) skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "build-read-project",

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-cloud-deploy/SKILL.md

@@ -9,7 +9,7 @@ description: >
 license: Apache-2.0
 metadata:
   author: yaalalabs
-  version: "0.5.0"
+  version: "0.6.0"
   category: user
 ---
 
@@ -52,10 +52,10 @@ Use official modules:
 - AWS containerized: `yaalalabs/ak-containerized/aws`
 - Azure serverless: `yaalalabs/ak-serverless/azurerm`
 - Azure containerized: `yaalalabs/ak-containerized/azurerm`
-- GCP serverless: local module at `ak-deployment/ak-gcp/serverless`
-- GCP containerized: local module at `ak-deployment/ak-gcp/containerized`
+- GCP serverless: `yaalalabs/ak-serverless/google`
+- GCP containerized: `yaalalabs/ak-containerized/google`
 
-Use current module version (`0.5.0`) unless user requests another.
+Use current module version (`0.6.0`) unless user requests another.
 
 AWS-only features in this skill:
 - `execution_mode`
@@ -77,7 +77,7 @@ When the user selects a session store, always update both app dependencies and `
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,redis]>=0.5.0"
+  "agentkernel[openai,api,redis]>=0.6.0"
 ]
 ```
 
@@ -100,7 +100,7 @@ session:
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,aws]>=0.5.0"
+  "agentkernel[openai,api,aws]>=0.6.0"
 ]
 ```
 
@@ -121,7 +121,7 @@ session:
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,azure]>=0.5.0"
+  "agentkernel[openai,api,azure]>=0.6.0"
 ]
 ```
 
@@ -143,7 +143,7 @@ session:
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,gcp]>=0.5.0"
+  "agentkernel[openai,api,gcp]>=0.6.0"
 ]
 ```
 
@@ -188,7 +188,7 @@ This is the single-Lambda pattern: use `request_handler` plus any `gateway_endpo
 ```hcl
 module "serverless_agents" {
   source  = "yaalalabs/ak-serverless/aws"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias        = var.product_alias
   env_alias            = var.env_alias
@@ -225,10 +225,24 @@ Use this for high throughput and long-running requests.
 
 This is the multi-artifact pattern used by the scalable example: a request handler zip, an agent-runner image, and a response-handler zip.
 
+Each Lambda can use one of three `package_type` values:
+
+
+| `package_type` | Artifact source                    | Required field(s)                                    | What Terraform does                                                                                                                                                                                       |
+| -------------- | ---------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `LocalZip`     | Local ZIP file or source directory | `package_path`                                       | Uses the Lambda module's local packaging support. No shared source bucket is managed by this module.                                                                                                      |
+| `S3Zip`        | ZIP artifact stored in S3          | **Either** `package_path` **or** `lambda_package_s3` | If `package_path` is provided, this module creates/uses a shared source bucket, uploads the ZIP, and deploys from S3. If `lambda_package_s3` is provided, Terraform uses the existing S3 object directly. |
+| `Image`        | Container image in ECR             | **Either** `ecr_image_uri` **or** `package_path`     | If `ecr_image_uri` is provided, Terraform uses the existing image. If `package_path` is provided, Terraform builds and pushes an image to ECR and deploys it.                                             |
+
+
+`package_path` and `lambda_package_s3`/`ecr_image_uri` are mutually exclusive — set only one.
+
+**Development / local build** (build artifacts locally before running `terraform apply`):
+
 ```hcl
 module "serverless_agents" {
   source  = "yaalalabs/ak-serverless/aws"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias      = var.product_alias
   env_alias          = var.env_alias
@@ -296,6 +310,52 @@ module "serverless_agents" {
 }
 ```
 
+**Production: external artifact sources (S3 / ECR)**
+
+Build and push artifacts in CI/CD, then point Terraform at them so `terraform apply` contains no local build step:
+
+```hcl
+  request_handler = {
+    module_name      = "rqst-hdlr"
+    function_name    = "request-handler"
+    handler_path     = "lambda_request_handler.handler"
+    package_type     = "S3Zip"
+    lambda_package_s3 = {
+      bucket = "my-lambda-packages-bucket"
+      key    = "dist_request_handler.zip"
+    }
+    timeout     = 45
+    memory_size = 256
+    environment_variables = { OPENAI_API_KEY = var.openai_api_key }
+  }
+
+  agent_runner = {
+    module_name   = "agent-runner"
+    function_name = "agent-runner"
+    handler_path  = "lambda_agent_runner.handler"
+    package_type  = "Image"
+    ecr_image_uri = "123456789012.dkr.ecr.us-west-2.amazonaws.com/agent-runner:latest"
+    timeout       = 45
+    memory_size   = 512
+    environment_variables = { OPENAI_API_KEY = var.openai_api_key }
+  }
+
+  response_handler = {
+    module_name      = "response-handler"
+    function_name    = "response-handler"
+    handler_path     = "lambda_response_handler.handler"
+    package_type     = "S3Zip"
+    lambda_package_s3 = {
+      bucket = "my-lambda-packages-bucket"
+      key    = "dist_response_handler.zip"
+    }
+    timeout     = 45
+    memory_size = 256
+  }
+```
+
+See [examples/aws-serverless/scalable-openai](https://github.com/yaalalabs/agent-kernel/tree/develop/examples/aws-serverless/scalable-openai) for a complete working example of this pattern.
+
 **Queue mode `config.yaml`** (bundled into every Lambda package — `execution.mode`, queue URLs, table names, and `max_receive_count` are all injected automatically by Terraform as environment variables; only set values that are NOT injected):
 
 ```yaml
@@ -317,7 +377,7 @@ session:
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,aws]>=0.5.0"  # include 'redis' if using Redis session/response store
+  "agentkernel[openai,api,aws]>=0.6.0"  # include 'redis' if using Redis session/response store
 ]
 ```
 
@@ -330,7 +390,7 @@ This follows the current websocket example shape: the request handler stays on t
 ```hcl
 module "serverless_agents" {
   source  = "yaalalabs/ak-serverless/aws"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias        = var.product_alias
   env_alias            = var.env_alias
@@ -474,7 +534,7 @@ session:
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,aws,redis,auth]>=0.5.0"
+  "agentkernel[openai,api,aws,redis,auth]>=0.6.0"
 ]
 ```
 
@@ -513,10 +573,12 @@ if __name__ == "__main__":
 
 ### Terraform Example
 
+**Local build (development)** — `package_path` points to the Docker build context:
+
 ```hcl
 module "containerized_agents" {
   source  = "yaalalabs/ak-containerized/aws"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias        = var.product_alias
   env_alias            = var.env_alias
@@ -536,6 +598,35 @@ module "containerized_agents" {
 }
 ```
 
+**Production: pre-built ECR image** — set `ecr_image_uri` instead of `package_path`. Terraform skips the local Docker build and deploys the specified image directly:
+
+```hcl
+module "containerized_agents" {
+  source  = "yaalalabs/ak-containerized/aws"
+  version = "0.6.0"
+
+  product_alias        = var.product_alias
+  env_alias            = var.env_alias
+  module_name          = var.module_name
+  ecr_image_uri        = "123456789012.dkr.ecr.us-west-2.amazonaws.com/my-app:v1.2.3"
+  region               = var.region
+  product_display_name = "AK ECS Deployment"
+
+  ecs_container_port = 8000
+  ecs_desired_count  = 2
+
+  create_dynamodb_memory_table = true
+
+  environment_variables = {
+    OPENAI_API_KEY = var.openai_api_key
+  }
+}
+```
+
+`package_path` and `ecr_image_uri` are mutually exclusive; exactly one must be set.
+
+See [examples/aws-containerized/openai-dynamodb](https://github.com/yaalalabs/agent-kernel/tree/develop/examples/aws-containerized/openai-dynamodb) for a complete example using an external ECR image.
+
 ## Azure Serverless (Functions + APIM)
 
 ### Agent Code Pattern
@@ -554,7 +645,7 @@ handler = AzureFunctions.handler
 ```hcl
 module "serverless_agents" {
   source  = "yaalalabs/ak-serverless/azurerm"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias        = var.product_alias
   env_alias            = var.env_alias
@@ -598,7 +689,7 @@ module "serverless_agents" {
 ```hcl
 module "containerized_agents" {
   source  = "yaalalabs/ak-containerized/azurerm"
-  version = "0.5.0"
+  version = "0.6.0"
 
   product_alias        = var.product_alias
   env_alias            = var.env_alias
@@ -641,7 +732,8 @@ def main() -> None:
 
 ```hcl
 module "serverless_agent" {
-  source = "../../ak-deployment/ak-gcp/serverless"
+  source  = "yaalalabs/ak-serverless/google"
+  version = "0.2.14"
 
   project_id           = var.project_id
   region               = var.region
@@ -669,7 +761,8 @@ module "serverless_agent" {
 
 ```hcl
 module "serverless_agent" {
-  source = "../../ak-deployment/ak-gcp/serverless"
+  source  = "yaalalabs/ak-serverless/google"
+  version = "0.2.14"
 
   project_id           = var.project_id
   region               = var.region
@@ -694,8 +787,8 @@ The module injects `AK_SESSION__TYPE=firestore` and `AK_SESSION__FIRESTORE__COLL
 
 ```toml
 dependencies = [
-  "agentkernel[openai,api,gcp]>=0.5.0"      # for Firestore sessions
-  # or: "agentkernel[openai,api,redis]>=0.5.0"  # for Redis sessions
+  "agentkernel[openai,api,gcp]>=0.6.0"      # for Firestore sessions
+  # or: "agentkernel[openai,api,redis]>=0.6.0"  # for Redis sessions
 ]
 ```
 
@@ -719,7 +812,8 @@ def main() -> None:
 
 ```hcl
 module "containerized_agent" {
-  source = "../../ak-deployment/ak-gcp/containerized"
+  source  = "yaalalabs/ak-containerized/google"
+  version = "0.2.14"
 
   project_id           = var.project_id
   region               = var.region

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-cloud-deploy/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-cloud-deploy",
   "description": "Evaluations for the ak-cloud-deploy (AWS/Azure deployment) skill with sync/async and scalable modes",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "deploy-aws-serverless",

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-init/SKILL.md

@@ -89,12 +89,12 @@ description = "<description>"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
-    "agentkernel[<extras>]>=0.5.0",
+    "agentkernel[<extras>]>=0.6.0",
 ]
 
 [dependency-groups]
 dev = [
-    "agentkernel[test]>=0.5.0",
+    "agentkernel[test]>=0.6.0",
     "black>=23.0.0",
     "isort>=5.0.0",
     "mypy>=1.0.0",

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-init/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-init",
   "description": "Evaluations for the ak-init (project scaffolding) skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "init-openai-cli",
@@ -150,7 +150,7 @@
         "[project]",
         "requires-python",
         "agentkernel[",
-        ">=0.5.0"
+        ">=0.6.0"
       ]
     }
   ]

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-test/SKILL.md

@@ -24,7 +24,7 @@ Update `pyproject.toml`:
 ```toml
 [dependency-groups]
 dev = [
-    "agentkernel[test]>=0.5.0",
+    "agentkernel[test]>=0.6.0",
     "black>=23.0.0",
     "isort>=5.0.0",
     "mypy>=1.0.0",
@@ -254,7 +254,7 @@ pip install "agentkernel[adk]"        # For Google ADK
 
 Or in `pyproject.toml`:
 ```toml
-dependencies = ["agentkernel[openai,api]>=0.5.0"]
+dependencies = ["agentkernel[openai,api]>=0.6.0"]
 ```
 
 #### Issue: Redis connection errors

{agentkernel-0.5.0 → agentkernel-0.6.0}/src/agentkernel/skills/ak-test/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill": "ak-test",
   "description": "Evaluations for the ak-test (testing and debugging) skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "evals": [
     {
       "id": "test-setup-cli",