agentskills-agentframework 0.2.0__tar.gz → 0.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/PKG-INFO +19 -5
  2. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/README.md +16 -2
  3. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/pyproject.toml +5 -3
  4. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/agentskills_agentframework/__init__.py +0 -0
  5. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/agentskills_agentframework/py.typed +0 -0
  6. {agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/agentskills_agentframework/tools.py +0 -0
{agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agentskills-agentframework
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: Microsoft Agent Framework integration for the Agent Skills format (https://agentskills.io)
5
5
  License: MIT
6
6
  Author: Pratik Panda
@@ -13,8 +13,8 @@ Classifier: Programming Language :: Python :: 3.12
13
13
  Classifier: Programming Language :: Python :: 3.13
14
14
  Classifier: Programming Language :: Python :: 3.14
15
15
  Classifier: Topic :: Software Development :: Libraries
16
- Requires-Dist: agent-framework (>=1.0.0b1)
17
- Requires-Dist: agentskills-core (>=0.1.0)
16
+ Requires-Dist: agent-framework (>=1.0.0b1,<2.0)
17
+ Requires-Dist: agentskills-core (>=0.1.0,<1.0)
18
18
  Project-URL: Homepage, https://agentskills.io
19
19
  Project-URL: Repository, https://github.com/pratikxpanda/agentskills-sdk
20
20
  Description-Content-Type: text/markdown
@@ -25,7 +25,7 @@ Description-Content-Type: text/markdown
25
25
  [![Python 3.12+](https://img.shields.io/pypi/pyversions/agentskills-agentframework)](https://pypi.org/project/agentskills-agentframework/)
26
26
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/pratikxpanda/agentskills-sdk/blob/main/LICENSE)
27
27
 
28
- > Microsoft Agent Framework integration for the [Agent Skills SDK](../../../README.md) — turn a skill registry into Agent Framework tools.
28
+ > Microsoft Agent Framework integration for the [Agent Skills SDK](../../../README.md) - turn a skill registry into Agent Framework tools.
29
29
 
30
30
  Generates a set of [Microsoft Agent Framework](https://pypi.org/project/agent-framework/) `FunctionTool` instances from a `SkillRegistry`, ready to be passed to any Agent Framework agent.
31
31
 
@@ -37,6 +37,8 @@ pip install agentskills-agentframework
37
37
 
38
38
  Requires Python 3.12+. Installs `agentskills-core` and `agent-framework` as dependencies.
39
39
 
40
+ > **Note:** `agent-framework` is currently a pre-release dependency (`>=1.0.0b1`). The constraint will be updated once a stable release is published.
41
+
40
42
  ## Usage
41
43
 
42
44
  ```python
@@ -78,12 +80,24 @@ Returns a list of Agent Framework function tools bound to the given registry.
78
80
 
79
81
  ### `get_tools_usage_instructions() -> str`
80
82
 
81
- Returns a markdown string explaining the progressive-disclosure workflow — read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.
83
+ Returns a markdown string explaining the progressive-disclosure workflow - read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.
82
84
 
83
85
  ## Example
84
86
 
85
87
  See [examples/agent-framework/](../../../examples/agent-framework/) for full working demos.
86
88
 
89
+ ## Error Handling
90
+
91
+ | Scenario | Exception |
92
+ | --- | --- |
93
+ | Skill not found in registry | `SkillNotFoundError` |
94
+ | Resource not found in skill | `ResourceNotFoundError` |
95
+ | Provider errors (HTTP, filesystem) | `AgentSkillsError` |
96
+
97
+ All exceptions inherit from `AgentSkillsError` (from `agentskills-core`).
98
+
99
+ > **Note:** Binary content (scripts, assets, references) is decoded as UTF-8 with `errors="replace"`. Non-decodable bytes are replaced with the Unicode replacement character (�).
100
+
87
101
  ## License
88
102
 
89
103
  MIT
{agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/README.md RENAMED
@@ -4,7 +4,7 @@
4
4
  [![Python 3.12+](https://img.shields.io/pypi/pyversions/agentskills-agentframework)](https://pypi.org/project/agentskills-agentframework/)
5
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/pratikxpanda/agentskills-sdk/blob/main/LICENSE)
6
6
 
7
- > Microsoft Agent Framework integration for the [Agent Skills SDK](../../../README.md) — turn a skill registry into Agent Framework tools.
7
+ > Microsoft Agent Framework integration for the [Agent Skills SDK](../../../README.md) - turn a skill registry into Agent Framework tools.
8
8
 
9
9
  Generates a set of [Microsoft Agent Framework](https://pypi.org/project/agent-framework/) `FunctionTool` instances from a `SkillRegistry`, ready to be passed to any Agent Framework agent.
10
10
 
@@ -16,6 +16,8 @@ pip install agentskills-agentframework
16
16
 
17
17
  Requires Python 3.12+. Installs `agentskills-core` and `agent-framework` as dependencies.
18
18
 
19
+ > **Note:** `agent-framework` is currently a pre-release dependency (`>=1.0.0b1`). The constraint will be updated once a stable release is published.
20
+
19
21
  ## Usage
20
22
 
21
23
  ```python
@@ -57,12 +59,24 @@ Returns a list of Agent Framework function tools bound to the given registry.
57
59
 
58
60
  ### `get_tools_usage_instructions() -> str`
59
61
 
60
- Returns a markdown string explaining the progressive-disclosure workflow — read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.
62
+ Returns a markdown string explaining the progressive-disclosure workflow - read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.
61
63
 
62
64
  ## Example
63
65
 
64
66
  See [examples/agent-framework/](../../../examples/agent-framework/) for full working demos.
65
67
 
68
+ ## Error Handling
69
+
70
+ | Scenario | Exception |
71
+ | --- | --- |
72
+ | Skill not found in registry | `SkillNotFoundError` |
73
+ | Resource not found in skill | `ResourceNotFoundError` |
74
+ | Provider errors (HTTP, filesystem) | `AgentSkillsError` |
75
+
76
+ All exceptions inherit from `AgentSkillsError` (from `agentskills-core`).
77
+
78
+ > **Note:** Binary content (scripts, assets, references) is decoded as UTF-8 with `errors="replace"`. Non-decodable bytes are replaced with the Unicode replacement character (�).
79
+
66
80
  ## License
67
81
 
68
82
  MIT
{agentskills_agentframework-0.2.0 → agentskills_agentframework-0.2.2}/pyproject.toml RENAMED
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "agentskills-agentframework"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "Microsoft Agent Framework integration for the Agent Skills format (https://agentskills.io)"
5
5
  license = "MIT"
6
6
  authors = ["Pratik Panda"]
@@ -18,8 +18,10 @@ classifiers = [
18
18
 
19
19
  [tool.poetry.dependencies]
20
20
  python = ">=3.12,<4.0"
21
- agentskills-core = ">=0.1.0"
22
- agent-framework = {version = ">=1.0.0b1", allow-prereleases = true}
21
+ agentskills-core = ">=0.1.0,<1.0"
22
+ # agent-framework has no stable release yet; pin to pre-release range.
23
+ # TODO: Remove allow-prereleases once a stable 1.0+ is available.
24
+ agent-framework = {version = ">=1.0.0b1,<2.0", allow-prereleases = true}
23
25
 
24
26
  [build-system]
25
27
  requires = ["poetry-core"]