agents-inc 0.2.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 (67) hide show
  1. agents_inc-0.2.0/CHANGELOG.md +60 -0
  2. agents_inc-0.2.0/CITATION.cff +24 -0
  3. agents_inc-0.2.0/LICENSE +145 -0
  4. agents_inc-0.2.0/MANIFEST.in +27 -0
  5. agents_inc-0.2.0/PKG-INFO +669 -0
  6. agents_inc-0.2.0/README.md +645 -0
  7. agents_inc-0.2.0/agents_inc/__init__.py +5 -0
  8. agents_inc-0.2.0/agents_inc/adapters/__init__.py +0 -0
  9. agents_inc-0.2.0/agents_inc/adapters/base.py +38 -0
  10. agents_inc-0.2.0/agents_inc/adapters/claude.py +8 -0
  11. agents_inc-0.2.0/agents_inc/adapters/codex.py +15 -0
  12. agents_inc-0.2.0/agents_inc/adapters/ollama.py +472 -0
  13. agents_inc-0.2.0/agents_inc/artifacts.py +170 -0
  14. agents_inc-0.2.0/agents_inc/bench.py +94 -0
  15. agents_inc-0.2.0/agents_inc/catalog_refresh.py +173 -0
  16. agents_inc-0.2.0/agents_inc/config_schema.py +141 -0
  17. agents_inc-0.2.0/agents_inc/control.py +641 -0
  18. agents_inc-0.2.0/agents_inc/derivation_store.py +142 -0
  19. agents_inc-0.2.0/agents_inc/doctor.py +175 -0
  20. agents_inc-0.2.0/agents_inc/envelope.py +177 -0
  21. agents_inc-0.2.0/agents_inc/free_caps.py +322 -0
  22. agents_inc-0.2.0/agents_inc/free_health.py +349 -0
  23. agents_inc-0.2.0/agents_inc/gateway.py +327 -0
  24. agents_inc-0.2.0/agents_inc/governance.json +138 -0
  25. agents_inc-0.2.0/agents_inc/host_ledger.py +183 -0
  26. agents_inc-0.2.0/agents_inc/hosts/__init__.py +0 -0
  27. agents_inc-0.2.0/agents_inc/hosts/gen_stubs.py +24 -0
  28. agents_inc-0.2.0/agents_inc/install/__init__.py +1 -0
  29. agents_inc-0.2.0/agents_inc/install/bundle.py +104 -0
  30. agents_inc-0.2.0/agents_inc/install/catalog.py +72 -0
  31. agents_inc-0.2.0/agents_inc/install/cli.py +179 -0
  32. agents_inc-0.2.0/agents_inc/install/discovery.py +48 -0
  33. agents_inc-0.2.0/agents_inc/install/dispatch.py +1287 -0
  34. agents_inc-0.2.0/agents_inc/install/doctor.py +92 -0
  35. agents_inc-0.2.0/agents_inc/install/hook.py +153 -0
  36. agents_inc-0.2.0/agents_inc/install/host_wiring.py +240 -0
  37. agents_inc-0.2.0/agents_inc/install/mcp_broker.py +361 -0
  38. agents_inc-0.2.0/agents_inc/install/models_cmd.py +92 -0
  39. agents_inc-0.2.0/agents_inc/install/paths.py +39 -0
  40. agents_inc-0.2.0/agents_inc/install/receipt.py +99 -0
  41. agents_inc-0.2.0/agents_inc/install/runtime.py +460 -0
  42. agents_inc-0.2.0/agents_inc/install/transaction.py +80 -0
  43. agents_inc-0.2.0/agents_inc/install/worker_mcp.py +176 -0
  44. agents_inc-0.2.0/agents_inc/keys.py +64 -0
  45. agents_inc-0.2.0/agents_inc/ledger.py +824 -0
  46. agents_inc-0.2.0/agents_inc/lineup_router.py +306 -0
  47. agents_inc-0.2.0/agents_inc/models.json +406 -0
  48. agents_inc-0.2.0/agents_inc/pipeline.py +361 -0
  49. agents_inc-0.2.0/agents_inc/policy.py +178 -0
  50. agents_inc-0.2.0/agents_inc/protocols.json +197 -0
  51. agents_inc-0.2.0/agents_inc/registry.py +179 -0
  52. agents_inc-0.2.0/agents_inc/reviewer.py +125 -0
  53. agents_inc-0.2.0/agents_inc/router.py +154 -0
  54. agents_inc-0.2.0/agents_inc/routing.json +35 -0
  55. agents_inc-0.2.0/agents_inc/schema.py +122 -0
  56. agents_inc-0.2.0/agents_inc/store.py +520 -0
  57. agents_inc-0.2.0/agents_inc/usage_join.py +221 -0
  58. agents_inc-0.2.0/agents_inc/verifier.py +81 -0
  59. agents_inc-0.2.0/agents_inc.egg-info/PKG-INFO +669 -0
  60. agents_inc-0.2.0/agents_inc.egg-info/SOURCES.txt +65 -0
  61. agents_inc-0.2.0/agents_inc.egg-info/dependency_links.txt +1 -0
  62. agents_inc-0.2.0/agents_inc.egg-info/entry_points.txt +2 -0
  63. agents_inc-0.2.0/agents_inc.egg-info/top_level.txt +2 -0
  64. agents_inc-0.2.0/pyproject.toml +55 -0
  65. agents_inc-0.2.0/setup.cfg +4 -0
  66. agents_inc-0.2.0/workerbees/__init__.py +50 -0
  67. agents_inc-0.2.0/workerbees/keys.py +49 -0
@@ -0,0 +1,60 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are recorded here. The format follows
4
+ [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow
5
+ [Semantic Versioning](https://semver.org/).
6
+
7
+ ## [Unreleased]
8
+
9
+ ## [0.2.0] — 2026-10-07
10
+
11
+ ### Added
12
+
13
+ - D47 — `agents-inc dispatch` wraps the dispatch loop.
14
+ - D48 — Fan-out cap for delegation.
15
+ - D49 — Codex tool access by rung.
16
+ - D50 — Codex becomes optional; both-optional deferred to v1.0.
17
+ - D51 — Credential-blind dispatch broker.
18
+ - D52 — Model pins, drift warnings, operator-decided bumps.
19
+ - D53 — QUICKREF loads by hook on first dispatch.
20
+ - D54 — delegate turns (`--resume` for Claude and Codex, broker `resume` tool) and a live `ask_lead` channel from a running Worker to its Lead.
21
+ - D49.1 — luna accepts `--tools` and `--write` like the other Codex aliases.
22
+ - Spec 018 wave 1 — MCP protocol hygiene for the broker and Worker servers: version negotiation (2025-06-18, 2024-11-05), `outputSchema` and `structuredContent` on broker tools, an explicit MCP timeout for Claude Workers, broker request ids that survive a restart, and redaction of encoded secret values.
23
+ - LICENSE: PolyForm Small Business License 1.0.0 plus a licensor-added term that forbids AI/ML training use.
24
+ - First PyPI package, `agents-inc` (import name `agents_inc`), built and published by a tag-triggered release workflow.
25
+ - Citation metadata for 0.2.0 in `CITATION.cff` and `.zenodo.json`.
26
+
27
+ ## [0.1.0] — 2026-10-01
28
+
29
+ First tagged release. The project is experimental: the governed path
30
+ (`WORKERBEES_GOVERNANCE`) is off by default.
31
+
32
+ ### Added
33
+
34
+ - Governed routing across Claude, Codex, Gemini, Mistral, OpenRouter, and an
35
+ opt-in local ollama pilot, with deterministic verification, cross-vendor
36
+ review, and an append-only ledger.
37
+ - `agents-inc` installer and launcher: install, repair, doctor, rollback, and
38
+ uninstall, with receipt-owned and reversible changes to host configuration.
39
+ - Host wiring: a managed instruction block and session hooks in each detected
40
+ host (Claude Code, Codex, Gemini).
41
+ - `@alias` side questions from inside a session (`at_route` hook), including
42
+ `@openrouter`. The installer now owns the hook and the alias links (#41, #38).
43
+ - Host ledger: delegated calls made from the host session (Agent, Task, and
44
+ DelegateAgent) leave a dispatch row, and `agents-inc ledger append` and
45
+ `agents-inc ledger pending` record verified returns (#36).
46
+ - Ledger fields for effort, tokens, cache use, and files created, plus a
47
+ time-window join against usage data (#36).
48
+ - Workerbee skill: rung names, a generated tier table with a drift check, a
49
+ rule to keep a delegate until its context ceiling (#28), and a fixed dispatch
50
+ header with fill-in slots and a renderer (#36, #4).
51
+ - Persona guard: an Agent or Task description that starts with a Codex persona
52
+ name (astra, sol, terra, luna) is denied, and duplicate spawns of the same
53
+ task from another session raise a warning (#17, #13).
54
+ - Transcript recovery helper for interrupted delegates (#13).
55
+
56
+ ### Fixed
57
+
58
+ - Provider health reports how fresh each result is, and the OpenRouter key is
59
+ found under either name, preferring `OPENROUTER_API_KEY` (#22).
60
+ - The launcher runs from any directory and reports a missing install (#35).
@@ -0,0 +1,24 @@
1
+ cff-version: 1.2.0
2
+ message: "If you use this software, please cite it using these metadata."
3
+ title: "agents_Inc"
4
+ abstract: "Governed multi-agent dispatch and verification layer that pools Claude, Codex, Gemini, Mistral, and OpenRouter capacity."
5
+ type: software
6
+ authors:
7
+ - family-names: "Mattioli"
8
+ given-names: "Dominik"
9
+ orcid: "https://orcid.org/0000-0002-7327-6337"
10
+ version: 0.2.0
11
+ date-released: 2026-10-07
12
+ doi: 10.5281/zenodo.22670100
13
+ license: PolyForm-Small-Business-1.0.0
14
+ license-url: "https://github.com/domattioli/agents_Inc/blob/main/LICENSE"
15
+ repository-code: "https://github.com/domattioli/agents_Inc"
16
+ keywords:
17
+ - claude-code
18
+ - multi-agent
19
+ - model-pooling
20
+ - governance
21
+ - codex
22
+ - delegation
23
+ - verification
24
+ - llm
@@ -0,0 +1,145 @@
1
+ # PolyForm Small Business License 1.0.0
2
+
3
+ <https://polyformproject.org/licenses/small-business/1.0.0>
4
+
5
+ ## Acceptance
6
+
7
+ In order to get any license under these terms, you must agree
8
+ to them as both strict obligations and conditions to all
9
+ your licenses.
10
+
11
+ ## Copyright License
12
+
13
+ The licensor grants you a copyright license for the
14
+ software to do everything you might do with the software
15
+ that would otherwise infringe the licensor's copyright
16
+ in it for any permitted purpose. However, you may
17
+ only distribute the software according to [Distribution
18
+ License](#distribution-license) and make changes or new works
19
+ based on the software according to [Changes and New Works
20
+ License](#changes-and-new-works-license).
21
+
22
+ ## Distribution License
23
+
24
+ The licensor grants you an additional copyright license
25
+ to distribute copies of the software. Your license
26
+ to distribute covers distributing the software with
27
+ changes and new works permitted by [Changes and New Works
28
+ License](#changes-and-new-works-license).
29
+
30
+ ## Notices
31
+
32
+ You must ensure that anyone who gets a copy of any part of
33
+ the software from you also gets a copy of these terms or the
34
+ URL for them above, as well as copies of any plain-text lines
35
+ beginning with `Required Notice:` that the licensor provided
36
+ with the software. For example:
37
+
38
+ > Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
39
+
40
+ ## Changes and New Works License
41
+
42
+ The licensor grants you an additional copyright license to
43
+ make changes and new works based on the software for any
44
+ permitted purpose.
45
+
46
+ ## Patent License
47
+
48
+ The licensor grants you a patent license for the software that
49
+ covers patent claims the licensor can license, or becomes able
50
+ to license, that you would infringe by using the software.
51
+
52
+ ## Fair Use
53
+
54
+ You may have "fair use" rights for the software under the
55
+ law. These terms do not limit them.
56
+
57
+ ## Small Business
58
+
59
+ Use of the software for the benefit of your company is use for
60
+ a permitted purpose if your company has fewer than 100 total
61
+ individuals working as employees and independent contractors,
62
+ and less than 1,000,000 USD (2019) total revenue in the prior
63
+ tax year. Adjust this revenue threshold for inflation according
64
+ to the United States Bureau of Labor Statistics' consumer price
65
+ index for all urban consumers, U.S. city average, for all items,
66
+ not seasonally adjusted, with 1982–1984=100 reference base.
67
+
68
+ ## No Other Rights
69
+
70
+ These terms do not allow you to sublicense or transfer any of
71
+ your licenses to anyone else, or prevent the licensor from
72
+ granting licenses to anyone else. These terms do not imply
73
+ any other licenses.
74
+
75
+ ## Patent Defense
76
+
77
+ If you make any written claim that the software infringes or
78
+ contributes to infringement of any patent, your patent license
79
+ for the software granted under these terms ends immediately. If
80
+ your company makes such a claim, your patent license ends
81
+ immediately for work on behalf of your company.
82
+
83
+ ## Violations
84
+
85
+ The first time you are notified in writing that you have
86
+ violated any of these terms, or done anything with the software
87
+ not covered by your licenses, your licenses can nonetheless
88
+ continue if you come into full compliance with these terms,
89
+ and take practical steps to correct past violations, within
90
+ 32 days of receiving notice. Otherwise, all your licenses
91
+ end immediately.
92
+
93
+ ## No Liability
94
+
95
+ ***As far as the law allows, the software comes as is, without
96
+ any warranty or condition, and the licensor will not be liable
97
+ to you for any damages arising out of these terms or the use
98
+ or nature of the software, under any kind of legal claim.***
99
+
100
+ ## Definitions
101
+
102
+ The **licensor** is the individual or entity offering these
103
+ terms, and the **software** is the software the licensor makes
104
+ available under these terms.
105
+
106
+ **You** refers to the individual or entity agreeing to these
107
+ terms.
108
+
109
+ **Your company** is any legal entity, sole proprietorship,
110
+ or other kind of organization that you work for, plus all
111
+ organizations that have control over, are under the control of,
112
+ or are under common control with that organization. **Control**
113
+ means ownership of substantially all the assets of an entity,
114
+ or the power to direct its management and policies by vote,
115
+ contract, or otherwise. Control can be direct or indirect.
116
+
117
+ **Your licenses** are all the licenses granted to you for the
118
+ software under these terms.
119
+
120
+ **Use** means anything you do with the software requiring one
121
+ of your licenses.
122
+
123
+ ------------------------------------------------------------------------
124
+
125
+ ADDITIONAL RESTRICTION — NO AI/ML TRAINING (licensor-added term)
126
+
127
+ This is an additional term layered on top of the PolyForm Small Business License
128
+ 1.0.0 above. Because of it, this combined document is NOT the unmodified
129
+ PolyForm Small Business License 1.0.0.
130
+
131
+ Notwithstanding any permitted purpose above, you may NOT, without a separate
132
+ written license from the licensor, use the software or any part of it:
133
+
134
+ (a) as training data, fine-tuning data, evaluation data, or other input for
135
+ any machine-learning or artificial-intelligence model, system, or
136
+ dataset; or
137
+
138
+ (b) for automated code generation, model distillation, or the construction of
139
+ embeddings, indexes, or retrieval corpora derived from the software.
140
+
141
+ This restriction applies even to otherwise-permitted use.
142
+
143
+ COMMERCIAL AND AI-TRAINING LICENSES
144
+
145
+ For commercial use, or for AI/ML training rights, contact: https://github.com/domattioli
@@ -0,0 +1,27 @@
1
+ # >>> release-ignore:begin (generated by DomI release-integrity — do not edit inside; edit .release-ignore.toml + regenerate)
2
+ prune .claude
3
+ prune .claude-plugin
4
+ prune .introspect
5
+ prune .githooks
6
+ prune .specify
7
+ prune .planning
8
+ global-exclude .domi-pin
9
+ global-exclude .zenodoignore
10
+ global-exclude .release-ignore.toml
11
+ global-exclude CLAUDE.md
12
+ global-exclude AGENTS.md
13
+ global-exclude claude_routine_instructions.md
14
+ global-exclude instructions_on_start.sh
15
+ prune scripts/hooks
16
+ prune docs/sessions
17
+ prune docs/introspections
18
+ prune specs
19
+ global-exclude *introspect*.yml
20
+ prune .github
21
+ prune tests
22
+ global-exclude .gitattributes
23
+ global-exclude .gitignore
24
+ # <<< release-ignore:end
25
+ include LICENSE README.md CHANGELOG.md CITATION.cff
26
+ recursive-include agents_inc *.json
27
+ global-exclude __pycache__ *.py[cod]