Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
21c1cf4
support skill scripts execution
SergeyMenshykh Mar 9, 2026
5aa82fb
fix mixed line endings
SergeyMenshykh Mar 9, 2026
a45e2e0
address comments and fix syntax issues
SergeyMenshykh Mar 9, 2026
60cca78
use few try/except instead of one
SergeyMenshykh Mar 9, 2026
4e8040c
change samples
SergeyMenshykh Mar 9, 2026
954d5be
validate either script path or script resource is set not both
SergeyMenshykh Mar 10, 2026
ce01ba7
fix: separate LLM args from runtime kwargs in skill script execution
SergeyMenshykh Mar 10, 2026
10af883
address pr review comments
SergeyMenshykh Mar 10, 2026
0a247a0
address PR review comments
SergeyMenshykh Mar 10, 2026
4944204
Merge branch 'main' into support-skills-script-execution
SergeyMenshykh Mar 10, 2026
3f00c39
Update python/packages/core/agent_framework/_skills.py
SergeyMenshykh Mar 10, 2026
4384be8
Update python/packages/core/agent_framework/_skills.py
SergeyMenshykh Mar 10, 2026
f3717f5
Update python/packages/core/agent_framework/_skills.py
SergeyMenshykh Mar 10, 2026
5066c43
1. Fixing the caching bug where parameters_schema would re-inspect o…
SergeyMenshykh Mar 10, 2026
f55e616
fix failing tests
SergeyMenshykh Mar 10, 2026
b0dc356
Merge branch 'main' into support-skills-script-execution
SergeyMenshykh Mar 10, 2026
6a9bd06
address pr review comments
SergeyMenshykh Mar 10, 2026
f43c523
address pr review comments
SergeyMenshykh Mar 11, 2026
47cec42
allow resource function returning any instead of sting
SergeyMenshykh Mar 11, 2026
d105d8f
address PR review comments
SergeyMenshykh Mar 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions python/packages/core/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ agent_framework/
├── _tools.py # Tool definitions and function invocation
├── _middleware.py # Middleware system for request/response interception
├── _sessions.py # AgentSession and context provider abstractions
├── _skills.py # Agent Skills system (models, executors, provider)
├── _mcp.py # Model Context Protocol support
├── _workflows/ # Workflow orchestration (sequential, concurrent, handoff, etc.)
├── openai/ # Built-in OpenAI client
Expand Down Expand Up @@ -63,6 +64,14 @@ agent_framework/
- **`BaseContextProvider`** - Base class for context providers (RAG, memory systems)
- **`BaseHistoryProvider`** - Base class for conversation history storage

### Skills (`_skills.py`)

- **`Skill`** - A skill definition bundling instructions (`content`) with metadata, resources, and scripts. Supports `@skill.resource` and `@skill.script` decorators for adding components.
- **`SkillResource`** - Named supplementary content attached to a skill; holds either static `content` or a dynamic `function` (sync or async). Exactly one must be provided.
- **`SkillScript`** - An executable script attached to a skill; holds either an inline `function` (code-defined, runs in-process) or a `path` to a file on disk (file-based, delegated to a runner). Exactly one must be provided.
- **`SkillScriptRunner`** - Protocol for file-based script execution. Any callable matching `(skill, script, args) -> Any` satisfies it. Code-defined scripts do not use a runner.
- **`SkillsProvider`** - Context provider (extends `BaseContextProvider`) that discovers file-based skills from `SKILL.md` files and/or accepts code-defined `Skill` instances. Follows progressive disclosure: advertise → load → read resources / run scripts.

### Workflows (`_workflows/`)

- **`Workflow`** - Graph-based workflow definition
Expand Down
10 changes: 9 additions & 1 deletion python/packages/core/agent_framework/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,13 @@
register_state_type,
)
from ._settings import SecretString, load_settings
from ._skills import Skill, SkillResource, SkillsProvider
from ._skills import (
Skill,
SkillResource,
SkillScript,
SkillScriptRunner,
SkillsProvider,
)
Comment thread
SergeyMenshykh marked this conversation as resolved.
from ._telemetry import (
AGENT_FRAMEWORK_USER_AGENT,
APP_INFO,
Expand Down Expand Up @@ -271,6 +277,8 @@
"SingleEdgeGroup",
"Skill",
"SkillResource",
"SkillScript",
"SkillScriptRunner",
"SkillsProvider",
"SubWorkflowRequestMessage",
"SubWorkflowResponseMessage",
Expand Down
Loading
Loading