agentengine-sdk-python 0.8.4__py3-none-any.whl → 0.8.5__py3-none-any.whl

ksadk/configs/env_registry.py

@@ -2,8 +2,35 @@ from __future__ import annotations
 
 from ksadk.configs.env_registry_pcm import PCM_ENV_VAR_REGISTRY_ITEMS
 from ksadk.configs.env_var_spec import EnvVarSpec
+from ksadk.configs.env_registry_studio import STUDIO_ENV_VAR_REGISTRY_ITEMS
 
 _ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
+    *STUDIO_ENV_VAR_REGISTRY_ITEMS,
+    EnvVarSpec(
+        "AGENTENGINE_CHANNEL_URL",
+        "studio",
+        "Channel service HTTPS base URL used by Studio and Channel Connector defaults.",
+    ),
+    EnvVarSpec(
+        "KSADK_MEMORY_POSTGRES_DSN", "memory", "Harness memory PostgreSQL DSN.",
+        sensitive=True, documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_OTEL_ENDPOINT", "harness", "Optional Harness trace export endpoint.",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_OTEL_SERVICE_NAME", "harness", "Harness trace service name.",
+        "ksadk-harness", documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_SANDBOX_API_KEY", "sandbox", "Legacy Skill MCP forwarded sandbox credential.",
+        sensitive=True, documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_SKILL_MANIFEST_TTL", "skills", "Skill manifest cache TTL in seconds.",
+        "60", documented=False,
+    ),
     EnvVarSpec(
         "KSADK_AGENT_EVAL",
         "evaluation",
@@ -244,41 +271,16 @@ _ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
         "KSADK_DSH_HOME",
         "plugins",
         (
-            "Directory containing the isolated DSH Profile; defaults to .agentkit/dsh-home "
-            "in the workspace."
+            "Directory containing isolated DSH Profiles; defaults to "
+            ".agentkit/dsh-homes/<pinned DSH version> in the workspace. "
+            "An existing explicit home requires a compatible version receipt before Core starts."
         ),
     ),
     EnvVarSpec(
         "KSADK_DSH_PROFILE",
         "plugins",
-        "DSH Profile name used by Studio and the plugin bridge.",
-        "studio",
-    ),
-    EnvVarSpec(
-        "KSADK_STUDIO_NO_SECURITY",
-        "studio",
-        "Disable Studio loopback session and CSRF checks for controlled tests only.",
-        "0",
-    ),
-    EnvVarSpec(
-        "KSADK_STUDIO_AUTHORIZER",
-        "studio",
-        "Internal authoring backend selector; bounded chat is the default and the "
-        "filesystem-capable Codex authorizer requires an explicit opt-in.",
-        "chat",
-        documented=False,
-    ),
-    EnvVarSpec(
-        "KSADK_STUDIO_SESSION_TOKEN",
-        "studio",
-        "Explicit local Studio browser session token; generated randomly when unset.",
-        sensitive=True,
-    ),
-    EnvVarSpec(
-        "KSADK_STUDIO_TRACE_CONTENT",
-        "studio",
-        "Persist Studio trace event content; set to 0 to retain metadata only.",
-        "1",
+        "DSH Profile name used by Studio and the plugin bridge; defaults to the web profile.",
+        "web",
     ),
     EnvVarSpec(
         "KSADK_COMMAND_", "sandbox", "Internal prefix for command policy environment controls."
@@ -390,14 +392,90 @@ _ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
         ),
         "false",
     ),
+    EnvVarSpec(
+        "KSADK_HARNESS_STATE_DIR",
+        "harness",
+        "Runtime server durable state directory (checkpoints and receipts).",
+    ),
     EnvVarSpec(
         "KSADK_LANGGRAPH_POSTGRES_REQUIREMENTS",
         "builders",
         "Internal bundled LangGraph PostgreSQL checkpointer requirement constant.",
     ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_ADDRESS_SPACE_BYTES",
+        "skills",
+        "Local-process RLIMIT_AS address-space bytes.",
+        "1073741824",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_CONTROLS",
+        "skills",
+        "Internal marker injected by the local Skill runtime backend.",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_CPU_SECONDS",
+        "skills",
+        "Local-process RLIMIT_CPU seconds.",
+        "120",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_ENV_ALLOWLIST",
+        "skills",
+        "Additional environment names allowed into local Skill commands.",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_MAX_FILE_BYTES",
+        "skills",
+        "Local-process RLIMIT_FSIZE bytes per file.",
+        "67108864",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_MAX_OPEN_FILES",
+        "skills",
+        "Local-process RLIMIT_NOFILE descriptor count.",
+        "256",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_MAX_OUTPUT_BYTES",
+        "skills",
+        "Maximum captured bytes for each local-process output stream.",
+        "1048576",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_MAX_PROCESSES",
+        "skills",
+        "Local-process RLIMIT_NPROC per-UID process count.",
+        "64",
+    ),
+    EnvVarSpec(
+        "KSADK_LOCAL_PROCESS_WALL_SECONDS",
+        "skills",
+        "Local-process hard wall-clock command limit.",
+        "900",
+    ),
     EnvVarSpec(
         "KSADK_LOCAL_SKILLS_DIR", "skills", "Local directory containing extracted Skill packages."
     ),
+    EnvVarSpec(
+        "KSADK_SKILL_SANDBOX_PROTOCOL",
+        "skills",
+        "Sandbox Skill delivery protocol. Only pinned_v1 is supported.",
+        "pinned_v1",
+    ),
+    EnvVarSpec(
+        "KSADK_SKILL_EVENT_FILE",
+        "skills",
+        "Internal per-run sandbox Skill event file.",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_SKILL_OUTPUT_TEXT_MAX_BYTES",
+        "skills",
+        "Maximum text artifact bytes returned by the Skill runtime agent.",
+        "65536",
+    ),
     EnvVarSpec("KSADK_LTM", "memory", "AICP long-term-memory connection prefix."),
     EnvVarSpec(
         "KSADK_LTM_ACCESS_KEY", "memory", "Long-term-memory API access key.", sensitive=True
@@ -451,6 +529,22 @@ _ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
     EnvVarSpec("KSADK_MEMORY_PREFIX", "memory", "Generic memory key prefix.", "ksadk:memory:"),
     EnvVarSpec("KSADK_MEMORY_TTL", "memory", "Generic memory default TTL seconds."),
     EnvVarSpec("KSADK_MEMORY_URL", "memory", "Generic memory backend URL.", sensitive=True),
+    EnvVarSpec(
+        "KSADK_MODEL_PROFILE_MAP",
+        "models",
+        "JSON object mapping model profile refs to provider model ids.",
+        sensitive=True,
+    ),
+    EnvVarSpec(
+        "KSADK_MODEL_STREAMING",
+        "models",
+        "Enable streaming model responses when supported (unset = auto).",
+    ),
+    EnvVarSpec(
+        "KSADK_MODEL_CAPABILITY_FILE",
+        "models",
+        "Provider capability declaration file produced by the model matrix.",
+    ),
     EnvVarSpec(
         "KSADK_MODEL_PROXY_AGENTS",
         "model_proxy",
@@ -866,7 +960,7 @@ _ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
         "KSADK_WEB_VERSION",
         "web",
         "Published KsADK Web npm version used for a reproducible wheel build.",
-        "0.3.7",
+        "0.3.10",
     ),
     EnvVarSpec(
         "KSADK_WORKING_SET_MAX_FILES",

ksadk/configs/env_registry_studio.py

@@ -0,0 +1,86 @@
+"""Studio startup, local security, and optional Teams authority configuration."""
+
+from ksadk.configs.env_var_spec import EnvVarSpec
+
+STUDIO_ENV_VAR_REGISTRY_ITEMS: tuple[EnvVarSpec, ...] = (
+    EnvVarSpec(
+        "KSADK_CHANNEL_API_TOKEN",
+        "studio",
+        "Channel API management token saved in protected Studio configuration.",
+        sensitive=True,
+    ),
+    EnvVarSpec(
+        "KSADK_CHANNEL_AGENT_",
+        "studio",
+        "Generated prefix for per-Agent Channel Connector credentials; not a user variable.",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_CHANNEL_WORKSPACE_ID",
+        "studio",
+        "Default Channel Connector workspace identity.",
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_LAZY_START",
+        "studio",
+        "Internal desktop startup mode; keep the Studio window responsive while optional DSH warmup runs.",
+        "0",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_CHANNEL_DEFAULT",
+        "studio",
+        "Default-enable the wheel-owned Studio Channel UI bundle after HTTP startup (1=on, 0=off).",
+        "1",
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_TEAMS_DEFAULT",
+        "studio",
+        "Default-enable the Teams plugin after HTTP startup (1=on, 0=off).",
+        "1",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_NO_SECURITY",
+        "studio",
+        "Disable Studio loopback session and CSRF checks for controlled tests only.",
+        "0",
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_AUTHORIZER",
+        "studio",
+        "Internal authoring backend selector; bounded chat is the default and the "
+        "filesystem-capable Codex authorizer requires an explicit opt-in.",
+        "chat",
+        documented=False,
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_SESSION_TOKEN",
+        "studio",
+        "Explicit local Studio browser session token; generated randomly when unset.",
+        sensitive=True,
+    ),
+    EnvVarSpec(
+        "KSADK_STUDIO_TRACE_CONTENT",
+        "studio",
+        "Persist Studio trace event content; set to 0 to retain metadata only.",
+        "1",
+    ),
+    EnvVarSpec(
+        "KSADK_TEAMS_SERVER_URL", "studio",
+        "Explicit Teams authority URL; unset keeps the local workspace authority.",
+    ),
+    EnvVarSpec(
+        "KSADK_TEAMS_ACCESS_TOKEN", "studio",
+        "Bearer credential for the configured Teams authority; unset uses configured request signing.",
+        sensitive=True,
+    ),
+    EnvVarSpec(
+        "KSADK_TEAMS_NODE_KIND", "studio", "Execution node kind sent during Teams registration.",
+        "local",
+    ),
+    EnvVarSpec(
+        "KSADK_TEAMS_NODE_NAME", "studio", "Execution node display name sent to the Teams authority.",
+        "system hostname",
+    ),
+)

ksadk/configs/global_config.py

@@ -9,7 +9,7 @@
     "model": {
         "OPENAI_API_KEY": "sk-xxx",
         "OPENAI_BASE_URL": "http://kspmas.ksyun.com/v1",
-        "OPENAI_MODEL_NAME": "glm-5.2"
+        "OPENAI_MODEL_NAME": "deepseek-v4.1-flash"
     },
     "cloud": {
         "KSYUN_ACCESS_KEY": "AKxxx",

ksadk/configs/settings.py

@@ -123,7 +123,7 @@ KSPMAS_INTERNAL_URL = f"http://{KSPMAS_INTERNAL_HOST}/v1"
 KSPMAS_PUBLIC_URL = "https://kspmas.ksyun.com/v1"
 
 # 默认模型
-DEFAULT_MODEL_NAME = "glm-5.2"
+DEFAULT_MODEL_NAME = "deepseek-v4.1-flash"
 
 
 def optimize_kspmas_url(url: str) -> str:
@@ -199,7 +199,7 @@ class ModelConfig:
 
     默认值:
         OPENAI_BASE_URL: 自动检测内网/外网，使用金山云模型服务
-        MODEL_NAME: glm-5.2
+        MODEL_NAME: deepseek-v4.1-flash
     """
 
     @property
@@ -234,7 +234,7 @@ class ModelConfig:
     def model_name(self) -> str:
         """获取模型名称
 
-        如果未配置，默认使用 glm-5.2。
+        如果未配置，默认使用 deepseek-v4.1-flash。
         """
         configured = _get_env(
             "OPENAI_MODEL_NAME",  # OpenAI 格式 (优先)

ksadk/connector/__init__.py

@@ -0,0 +1,17 @@
+"""Optional outbound connectors for KsADK agents."""
+
+from ksadk.connector.channel import (
+    ChannelConnector,
+    ConnectorStatus,
+    InvokeRequest,
+    ProtocolError,
+    create_channel_connector,
+)
+
+__all__ = [
+    "ChannelConnector",
+    "ConnectorStatus",
+    "InvokeRequest",
+    "ProtocolError",
+    "create_channel_connector",
+]