beunec-asps 0.1.0__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 (18) hide show
  1. beunec_asps-0.1.0/LICENSE +21 -0
  2. beunec_asps-0.1.0/PKG-INFO +142 -0
  3. beunec_asps-0.1.0/README.md +113 -0
  4. beunec_asps-0.1.0/pyproject.toml +55 -0
  5. beunec_asps-0.1.0/setup.cfg +4 -0
  6. beunec_asps-0.1.0/src/beunec_asps/__init__.py +97 -0
  7. beunec_asps-0.1.0/src/beunec_asps/ans.py +304 -0
  8. beunec_asps-0.1.0/src/beunec_asps/asd.py +185 -0
  9. beunec_asps-0.1.0/src/beunec_asps/asr.py +302 -0
  10. beunec_asps-0.1.0/src/beunec_asps/builder.py +280 -0
  11. beunec_asps-0.1.0/src/beunec_asps/py.typed +0 -0
  12. beunec_asps-0.1.0/src/beunec_asps/templates.py +377 -0
  13. beunec_asps-0.1.0/src/beunec_asps/types.py +230 -0
  14. beunec_asps-0.1.0/src/beunec_asps.egg-info/PKG-INFO +142 -0
  15. beunec_asps-0.1.0/src/beunec_asps.egg-info/SOURCES.txt +16 -0
  16. beunec_asps-0.1.0/src/beunec_asps.egg-info/dependency_links.txt +1 -0
  17. beunec_asps-0.1.0/src/beunec_asps.egg-info/top_level.txt +1 -0
  18. beunec_asps-0.1.0/tests/test_asps.py +295 -0
beunec_asps-0.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Beunec Technologies, Inc.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
beunec_asps-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,142 @@
1
+ Metadata-Version: 2.4
2
+ Name: beunec-asps
3
+ Version: 0.1.0
4
+ Summary: Agentic-System-Prompt-as-a-Skill (ASPS) — A three-layer framework for deterministic skill construction in agentic systems.
5
+ Author-email: "Beunec Technologies, Inc." <support@beunec.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/beunec/beunec-asps
8
+ Project-URL: Documentation, https://github.com/beunec/beunec-asps#readme
9
+ Project-URL: Repository, https://github.com/beunec/beunec-asps
10
+ Project-URL: Issues, https://github.com/beunec/beunec-asps/issues
11
+ Keywords: asps,agentic,system-prompt,skill,llm,ai-agent,distillation,reinforcement,multi-agent,beunec
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.9
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
23
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
24
+ Classifier: Typing :: Typed
25
+ Requires-Python: >=3.9
26
+ Description-Content-Type: text/markdown
27
+ License-File: LICENSE
28
+ Dynamic: license-file
29
+
30
+ # beunec-asps
31
+
32
+ **Agentic-System-Prompt-as-a-Skill™ (ASPS™)** — A lightweight, zero-dependency Python framework for deterministic skill construction in agentic systems.
33
+
34
+ > An LLM does not "have skills." It has parameters. ASPS™ provides the infrastructure that *makes* an agentic system skillful.
35
+
36
+ [![PyPI](https://img.shields.io/pypi/v/beunec-asps)](https://pypi.org/project/beunec-asps/)
37
+ [![Python](https://img.shields.io/pypi/pyversions/beunec-asps)](https://pypi.org/project/beunec-asps/)
38
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
39
+
40
+ ## Install
41
+
42
+ ```bash
43
+ pip install beunec-asps
44
+ ```
45
+
46
+ ## Quick Start
47
+
48
+ ```python
49
+ from beunec_asps import (
50
+ ASPSBuilder,
51
+ create_heuristic,
52
+ create_pseudonym_protocol,
53
+ NetworkTopologies,
54
+ HEURISTIC_LIBRARIES,
55
+ )
56
+
57
+ # Build a skill in 4 lines
58
+ skill = (
59
+ ASPSBuilder(name="Stock Analyst", domain="Equity Research", description="...")
60
+ .distill(HEURISTIC_LIBRARIES["financial_stock_analyst"])
61
+ .reinforce(
62
+ pseudonym_protocol=create_pseudonym_protocol(
63
+ identity="CFA Charterholder",
64
+ persona="A disciplined equity research analyst.",
65
+ ),
66
+ guardrail_presets=["standard", "financial"],
67
+ )
68
+ .network(NetworkTopologies.hub_and_spoke(
69
+ orchestrator_label="Lead Analyst",
70
+ spokes=[{"label": "Market Data API", "node_type": "api", "capabilities": ["quotes"]}],
71
+ ))
72
+ .compile()
73
+ )
74
+
75
+ # Use the compiled system prompt with any LLM
76
+ print(skill.compiled_system_prompt)
77
+ ```
78
+
79
+ ## Pre-Built Templates
80
+
81
+ ```python
82
+ from beunec_asps.templates import ASPS_TEMPLATES
83
+
84
+ # 7 ready-to-use skill templates
85
+ skill = ASPS_TEMPLATES["financial_stock_analyst"]()
86
+ skill = ASPS_TEMPLATES["full_stack_developer"]()
87
+ skill = ASPS_TEMPLATES["scientific_researcher"]()
88
+ skill = ASPS_TEMPLATES["content_creator"]()
89
+ skill = ASPS_TEMPLATES["private_equity_analyst"]()
90
+ skill = ASPS_TEMPLATES["financial_investment_analyst"]()
91
+ skill = ASPS_TEMPLATES["academia_professor"]()
92
+ ```
93
+
94
+ ## The Three Techniques
95
+
96
+ | Layer | Technique | Purpose |
97
+ |---|---|---|
98
+ | 1 | **ASD™** (Agentic Skill Distillation) | Extract expert heuristics → deterministic instruction chains |
99
+ | 2 | **ASR™** (Agentic Skill Reinforcement) | Behavioral checkpoints, pseudonym protocols, ICRL, guardrails |
100
+ | 3 | **ANS™** (Agentic Network System) | Wire skills into governed multi-agent network topologies |
101
+
102
+ ## Works With Everything
103
+
104
+ `beunec-asps` is **zero-dependency** and produces plain strings. It works alongside — never conflicts with:
105
+
106
+ - **LangChain** / **LangGraph** — use the compiled prompt as your agent's system message
107
+ - **OpenAI SDK** — pass `skill.compiled_system_prompt` as the system message
108
+ - **Anthropic SDK** — same
109
+ - **AutoGen** / **CrewAI** — use as the internal prompt for any agent in your graph
110
+ - **Any LLM** — it's just a string
111
+
112
+ ## Custom Skills
113
+
114
+ ```python
115
+ from beunec_asps import ASPSBuilder, create_heuristic, create_pseudonym_protocol, NetworkTopologies
116
+
117
+ skill = (
118
+ ASPSBuilder(name="My Expert", domain="My Domain", description="What it does")
119
+ .distill([
120
+ create_heuristic(name="Step 1", instruction="Do this first."),
121
+ create_heuristic(name="Step 2", instruction="Then do this."),
122
+ ])
123
+ .reinforce(
124
+ pseudonym_protocol=create_pseudonym_protocol(
125
+ identity="Domain Expert",
126
+ persona="An experienced professional.",
127
+ ),
128
+ guardrail_presets=["standard"],
129
+ )
130
+ .network(NetworkTopologies.pipeline(stages=[
131
+ {"label": "Agent A", "node_type": "agent", "capabilities": ["analyze"]},
132
+ {"label": "Agent B", "node_type": "agent", "capabilities": ["synthesize"]},
133
+ ]))
134
+ .compile()
135
+ )
136
+ ```
137
+
138
+ ## License
139
+
140
+ MIT — © 2025 Beunec Technologies, Inc.
141
+
142
+ ASPS™, ASD™, ASR™, ANS™ are trademarks of Beunec Technologies, Inc.
beunec_asps-0.1.0/README.md ADDED
@@ -0,0 +1,113 @@
1
+ # beunec-asps
2
+
3
+ **Agentic-System-Prompt-as-a-Skill™ (ASPS™)** — A lightweight, zero-dependency Python framework for deterministic skill construction in agentic systems.
4
+
5
+ > An LLM does not "have skills." It has parameters. ASPS™ provides the infrastructure that *makes* an agentic system skillful.
6
+
7
+ [![PyPI](https://img.shields.io/pypi/v/beunec-asps)](https://pypi.org/project/beunec-asps/)
8
+ [![Python](https://img.shields.io/pypi/pyversions/beunec-asps)](https://pypi.org/project/beunec-asps/)
9
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10
+
11
+ ## Install
12
+
13
+ ```bash
14
+ pip install beunec-asps
15
+ ```
16
+
17
+ ## Quick Start
18
+
19
+ ```python
20
+ from beunec_asps import (
21
+ ASPSBuilder,
22
+ create_heuristic,
23
+ create_pseudonym_protocol,
24
+ NetworkTopologies,
25
+ HEURISTIC_LIBRARIES,
26
+ )
27
+
28
+ # Build a skill in 4 lines
29
+ skill = (
30
+ ASPSBuilder(name="Stock Analyst", domain="Equity Research", description="...")
31
+ .distill(HEURISTIC_LIBRARIES["financial_stock_analyst"])
32
+ .reinforce(
33
+ pseudonym_protocol=create_pseudonym_protocol(
34
+ identity="CFA Charterholder",
35
+ persona="A disciplined equity research analyst.",
36
+ ),
37
+ guardrail_presets=["standard", "financial"],
38
+ )
39
+ .network(NetworkTopologies.hub_and_spoke(
40
+ orchestrator_label="Lead Analyst",
41
+ spokes=[{"label": "Market Data API", "node_type": "api", "capabilities": ["quotes"]}],
42
+ ))
43
+ .compile()
44
+ )
45
+
46
+ # Use the compiled system prompt with any LLM
47
+ print(skill.compiled_system_prompt)
48
+ ```
49
+
50
+ ## Pre-Built Templates
51
+
52
+ ```python
53
+ from beunec_asps.templates import ASPS_TEMPLATES
54
+
55
+ # 7 ready-to-use skill templates
56
+ skill = ASPS_TEMPLATES["financial_stock_analyst"]()
57
+ skill = ASPS_TEMPLATES["full_stack_developer"]()
58
+ skill = ASPS_TEMPLATES["scientific_researcher"]()
59
+ skill = ASPS_TEMPLATES["content_creator"]()
60
+ skill = ASPS_TEMPLATES["private_equity_analyst"]()
61
+ skill = ASPS_TEMPLATES["financial_investment_analyst"]()
62
+ skill = ASPS_TEMPLATES["academia_professor"]()
63
+ ```
64
+
65
+ ## The Three Techniques
66
+
67
+ | Layer | Technique | Purpose |
68
+ |---|---|---|
69
+ | 1 | **ASD™** (Agentic Skill Distillation) | Extract expert heuristics → deterministic instruction chains |
70
+ | 2 | **ASR™** (Agentic Skill Reinforcement) | Behavioral checkpoints, pseudonym protocols, ICRL, guardrails |
71
+ | 3 | **ANS™** (Agentic Network System) | Wire skills into governed multi-agent network topologies |
72
+
73
+ ## Works With Everything
74
+
75
+ `beunec-asps` is **zero-dependency** and produces plain strings. It works alongside — never conflicts with:
76
+
77
+ - **LangChain** / **LangGraph** — use the compiled prompt as your agent's system message
78
+ - **OpenAI SDK** — pass `skill.compiled_system_prompt` as the system message
79
+ - **Anthropic SDK** — same
80
+ - **AutoGen** / **CrewAI** — use as the internal prompt for any agent in your graph
81
+ - **Any LLM** — it's just a string
82
+
83
+ ## Custom Skills
84
+
85
+ ```python
86
+ from beunec_asps import ASPSBuilder, create_heuristic, create_pseudonym_protocol, NetworkTopologies
87
+
88
+ skill = (
89
+ ASPSBuilder(name="My Expert", domain="My Domain", description="What it does")
90
+ .distill([
91
+ create_heuristic(name="Step 1", instruction="Do this first."),
92
+ create_heuristic(name="Step 2", instruction="Then do this."),
93
+ ])
94
+ .reinforce(
95
+ pseudonym_protocol=create_pseudonym_protocol(
96
+ identity="Domain Expert",
97
+ persona="An experienced professional.",
98
+ ),
99
+ guardrail_presets=["standard"],
100
+ )
101
+ .network(NetworkTopologies.pipeline(stages=[
102
+ {"label": "Agent A", "node_type": "agent", "capabilities": ["analyze"]},
103
+ {"label": "Agent B", "node_type": "agent", "capabilities": ["synthesize"]},
104
+ ]))
105
+ .compile()
106
+ )
107
+ ```
108
+
109
+ ## License
110
+
111
+ MIT — © 2025 Beunec Technologies, Inc.
112
+
113
+ ASPS™, ASD™, ASR™, ANS™ are trademarks of Beunec Technologies, Inc.
beunec_asps-0.1.0/pyproject.toml ADDED
@@ -0,0 +1,55 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "beunec-asps"
7
+ version = "0.1.0"
8
+ authors = [{ name = "Beunec Technologies, Inc.", email = "support@beunec.com" }]
9
+ description = "Agentic-System-Prompt-as-a-Skill (ASPS) — A three-layer framework for deterministic skill construction in agentic systems."
10
+ readme = "README.md"
11
+ license = { text = "MIT" }
12
+ requires-python = ">=3.9"
13
+ dependencies = []
14
+ classifiers = [
15
+ "Development Status :: 4 - Beta",
16
+ "Intended Audience :: Developers",
17
+ "Operating System :: OS Independent",
18
+ "License :: OSI Approved :: MIT License",
19
+ "Programming Language :: Python :: 3",
20
+ "Programming Language :: Python :: 3.9",
21
+ "Programming Language :: Python :: 3.10",
22
+ "Programming Language :: Python :: 3.11",
23
+ "Programming Language :: Python :: 3.12",
24
+ "Programming Language :: Python :: 3.13",
25
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
26
+ "Topic :: Software Development :: Libraries :: Python Modules",
27
+ "Typing :: Typed",
28
+ ]
29
+ keywords = [
30
+ "asps",
31
+ "agentic",
32
+ "system-prompt",
33
+ "skill",
34
+ "llm",
35
+ "ai-agent",
36
+ "distillation",
37
+ "reinforcement",
38
+ "multi-agent",
39
+ "beunec",
40
+ ]
41
+
42
+ [project.urls]
43
+ Homepage = "https://github.com/beunec/beunec-asps"
44
+ Documentation = "https://github.com/beunec/beunec-asps#readme"
45
+ Repository = "https://github.com/beunec/beunec-asps"
46
+ Issues = "https://github.com/beunec/beunec-asps/issues"
47
+
48
+ [tool.setuptools]
49
+ package-dir = { "" = "src" }
50
+
51
+ [tool.setuptools.packages.find]
52
+ where = ["src"]
53
+
54
+ [tool.setuptools.package-data]
55
+ beunec_asps = ["py.typed"]
beunec_asps-0.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
beunec_asps-0.1.0/src/beunec_asps/__init__.py ADDED
@@ -0,0 +1,97 @@
1
+ """
2
+ Beunec Technologies, Inc. — Agentic-System-Prompt-as-a-Skill™ (ASPS™)
3
+
4
+ A lightweight, zero-dependency Python framework for deterministic skill
5
+ construction in agentic systems.
6
+
7
+ Three techniques:
8
+ 1. ASD™ — Agentic Skill Distillation
9
+ 2. ASR™ — Agentic Skill Reinforcement
10
+ 3. ANS™ — Agentic Network System
11
+ """
12
+
13
+ from beunec_asps.types import (
14
+ DistilledHeuristic,
15
+ SkillDistillation,
16
+ DistillationMetadata,
17
+ BehavioralCheckpoint,
18
+ PseudonymProtocol,
19
+ ICRLConfig,
20
+ AuditConfig,
21
+ SkillReinforcement,
22
+ HealthCheck,
23
+ NetworkNode,
24
+ RetryPolicy,
25
+ TaskHandoff,
26
+ NetworkPolicies,
27
+ AgenticNetwork,
28
+ ASPSBuildProgress,
29
+ ASPS,
30
+ )
31
+ from beunec_asps.asd import (
32
+ create_heuristic,
33
+ compile_heuristics_to_prompt,
34
+ distill,
35
+ HEURISTIC_LIBRARIES,
36
+ )
37
+ from beunec_asps.asr import (
38
+ create_checkpoint,
39
+ create_pseudonym_protocol,
40
+ create_icrl_config,
41
+ reinforce,
42
+ wrap_prompt_with_reinforcement,
43
+ GUARDRAIL_PRESETS,
44
+ CHECKPOINT_PRESETS,
45
+ )
46
+ from beunec_asps.ans import (
47
+ create_node,
48
+ create_handoff,
49
+ build_network,
50
+ generate_network_prompt_block,
51
+ NetworkTopologies,
52
+ )
53
+ from beunec_asps.builder import ASPSBuilder, build_asps
54
+
55
+ __all__ = [
56
+ # Types
57
+ "DistilledHeuristic",
58
+ "SkillDistillation",
59
+ "DistillationMetadata",
60
+ "BehavioralCheckpoint",
61
+ "PseudonymProtocol",
62
+ "ICRLConfig",
63
+ "AuditConfig",
64
+ "SkillReinforcement",
65
+ "HealthCheck",
66
+ "NetworkNode",
67
+ "RetryPolicy",
68
+ "TaskHandoff",
69
+ "NetworkPolicies",
70
+ "AgenticNetwork",
71
+ "ASPSBuildProgress",
72
+ "ASPS",
73
+ # ASD
74
+ "create_heuristic",
75
+ "compile_heuristics_to_prompt",
76
+ "distill",
77
+ "HEURISTIC_LIBRARIES",
78
+ # ASR
79
+ "create_checkpoint",
80
+ "create_pseudonym_protocol",
81
+ "create_icrl_config",
82
+ "reinforce",
83
+ "wrap_prompt_with_reinforcement",
84
+ "GUARDRAIL_PRESETS",
85
+ "CHECKPOINT_PRESETS",
86
+ # ANS
87
+ "create_node",
88
+ "create_handoff",
89
+ "build_network",
90
+ "generate_network_prompt_block",
91
+ "NetworkTopologies",
92
+ # Builder
93
+ "ASPSBuilder",
94
+ "build_asps",
95
+ ]
96
+
97
+ __version__ = "0.1.0"