praxo-core 0.8.0 → 0.8.2

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 (8) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +45 -4
  3. data/REGISTRY.md +8 -6
  4. data/api/0.8.1.txt +135 -0
  5. data/api/0.8.2.txt +135 -0
  6. data/llms.md +6 -6
  7. data/llms.txt +6 -6
  8. metadata +3 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 16f51199165f1dfbb11aea069e4aea7b246a352e900464e43fd6017a32187df5
4
- data.tar.gz: 10bcb9c2f8856b6ad318f8a45e0b5cb58ed8aac3e1dc0b3e4ee43ea03f7b53f2
3
+ metadata.gz: 2511d9120f9fdcf0969637cbd95a035fa4cba3c975ddd4241228072c0947c810
4
+ data.tar.gz: 71654456f560e5a7e8f9634fffa0a564ecc60c1d31ceb400769acaa74964e382
5
5
  SHA512:
6
- metadata.gz: 3b7fef8001aa05f6c884f850820298a213cb6abafc8e0751a9b74867e3221ed79058ba1da42555d9236db1c73f7f7d6c53f5a333ab98397e9359acc867a2a2ff
7
- data.tar.gz: d70c6a3138e435d5c7f77bde234377272b2dbdddb19514e2efa242c29cd10757fc586dbf56ee7dcaf1247eba7422ea637fa7f737f7c6a07ccc5218ce045cb2f1
6
+ metadata.gz: e7f654ee7aa6ff2c8f982b5320b53d831e5d0f5178c61c68418b173edc2254a7e1425c5e80e7d8865f91f922b2ccbd02492a4516a9da8c5ec5bbe8acb6ba2d90
7
+ data.tar.gz: 79019fffde0873e05e655a99dc8dfbfea16cb671591fe1b03300c1afe0ffd51dfd8bf1c1e37c2094c51b66eb624e98539b7d46d3b622a6dfda5a1eff7aea0c87
data/README.md CHANGED
@@ -5,16 +5,20 @@ native Ruby Core: an agent loop with tool registration and dispatch, policy
5
5
  hooks, typed events, memory, checkpoints, context budgets, middleware, JSON
6
6
  Schema validation, and plugin manifest parsing.
7
7
 
8
+ Use it when an existing Ruby application needs a governed model/tool loop
9
+ without adding a sidecar in another language. It is not an HTTP user agent,
10
+ crawler, hosted agent service, or model provider.
11
+
8
12
  The normative contract is [`spec/`](../../spec/README.md); Go remains the
9
13
  reference implementation.
10
14
 
11
15
  - `SPEC_VERSION`: `0.2.0`
12
- - Core version: `0.4.1`
16
+ - Core version: `0.8.2`
13
17
  - Tier: core
14
18
  - License: MIT
15
19
  - Dependencies: Ruby standard library only
16
20
  - Ruby source repository: https://github.com/axisvela/praxo-core-ruby
17
- - The latest RubyGems package is `praxo-core@0.4.1`
21
+ - The latest RubyGems package is `praxo-core@0.8.2`
18
22
 
19
23
  ## Registry and Coding-Agent Entry
20
24
 
@@ -22,9 +26,46 @@ reference implementation.
22
26
  - Machine-readable entry: [llms.txt](https://github.com/axisvela/praxo-core/blob/main/language/ruby/llms.txt) and [llms.md](https://github.com/axisvela/praxo-core/blob/main/language/ruby/llms.md)
23
27
  - [Examples](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples): runnable language-specific examples.
24
28
  - Coding-agent contract: [docs/getting-started/coding-agents.md](https://github.com/axisvela/praxo-core/blob/main/docs/getting-started/coding-agents.md)
25
- - Registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.7.0)
29
+ - Registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.1)
26
30
  - Community: [X](https://x.com/axisvela) · [Weibo](https://weibo.com/u/1936025761)
27
31
 
32
+ ## Get started
33
+
34
+ Install the published package:
35
+
36
+ ```bash
37
+ gem install praxo-core
38
+ ```
39
+
40
+ Then run the smallest deterministic example:
41
+
42
+ - [Consumer starter](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/consumer): explicit tool scope and a deny check.
43
+ - [Live model](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/live-model): connect an OpenAI-compatible endpoint and register `get_time`.
44
+
45
+ See the [Ruby documentation](https://axisvela.github.io/praxo-core/languages/ruby/) for the full API and the
46
+ [language matrix](https://axisvela.github.io/praxo-core/languages/matrix/) for
47
+ current scope.
48
+
49
+ ## Examples
50
+
51
+ Runnable examples live under [`language/ruby/examples`](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples).
52
+
53
+ | Goal | Example |
54
+ | --- | --- |
55
+ | Install and deny one unsafe call | [consumer](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/consumer) |
56
+ | Connect a real model | [live-model](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/live-model) |
57
+ | Connect MCP tools | [mcp](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/mcp) |
58
+ | Validate structured output | [structured-output](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/structured-output) |
59
+ | Stream a response | [streaming](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/streaming) |
60
+ | Add identity and policy | [identity-policy](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/identity-policy) |
61
+ | Persist checkpoints | [checkpoint](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/checkpoint) |
62
+ | Run behind HTTP | [service](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/service) |
63
+ | Approve or edit a tool call | [hitl](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/hitl) |
64
+ | Resume a multi-turn session | [session-checkpoint](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/session-checkpoint) |
65
+ | Retry transient failures | [retry](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/retry) |
66
+ | Add provider fallback | [provider-fallback](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/provider-fallback) |
67
+ | Observe agent events | [event-sink](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples/event-sink) |
68
+
28
69
  ## Install
29
70
 
30
71
  ```bash
@@ -134,5 +175,5 @@ before emitting.
134
175
 
135
176
  ## Release
136
177
 
137
- Tag shape: `ruby/v0.8.0`. The tag targets `SPEC_VERSION` `0.2.0`. See
178
+ Tag shape: `ruby/v0.8.2`. The tag targets `SPEC_VERSION` `0.2.0`. See
138
179
  [CHANGELOG.md](CHANGELOG.md) for per-release changes and compatibility notes.
data/REGISTRY.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # PRAXO-CORE Ruby Registry Introduction
2
2
 
3
- **Status:** published; split source repository. Source version `0.8.0`, source
4
- tag `ruby/v0.8.0`. Published registry version: `0.7.0`. Registry
3
+ **Status:** published; split source repository. Source version `0.8.2`, source
4
+ tag `ruby/v0.8.2`. Published registry version: `0.8.1`. Registry
5
5
  pages are release snapshots; verify the published version before relying on a
6
6
  feature.
7
7
 
@@ -9,17 +9,19 @@ feature.
9
9
 
10
10
  PRAXO-CORE is an embeddable, MIT-licensed agent framework. This gem is its native Ruby Core: an agent loop with tool registration and dispatch, policy hooks, typed events, memory, checkpoints, context budgets, middleware, JSON Schema validation, and plugin manifest parsing.
11
11
 
12
+ Use it when an existing Ruby application needs a governed model/tool loop without adding a sidecar in another language. It is not an HTTP user agent, crawler, hosted agent service, or model provider.
13
+
12
14
  ## Package
13
15
 
14
16
  | Field | Value |
15
17
  | --- | --- |
16
18
  | Package | `praxo-core` |
17
- | Registry | [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.7.0) |
18
- | Source version | `0.8.0` |
19
- | Published registry version | `0.7.0` |
19
+ | Registry | [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.1) |
20
+ | Source version | `0.8.2` |
21
+ | Published registry version | `0.8.1` |
20
22
  | Install (published) | `gem install praxo-core` |
21
23
  | Install (source/release prepared) | `gem install praxo-core` |
22
- | Source tag | `ruby/v0.8.0` |
24
+ | Source tag | `ruby/v0.8.2` |
23
25
  | Tier | Core |
24
26
  | Contract | `SPEC_VERSION` `0.2.0` |
25
27
  | Documentation | https://axisvela.github.io/praxo-core/languages/ruby/ |
data/api/0.8.1.txt ADDED
@@ -0,0 +1,135 @@
1
+ # PRAXO-CORE Ruby API 0.8.1
2
+ # SPEC_VERSION 0.2.0
3
+
4
+ class AgentOptions
5
+ class CallLimit
6
+ class CheckpointAllowlist
7
+ class ContextBudget
8
+ class Error
9
+ class FilterSink
10
+ class FuncRetriever
11
+ class FuncTool
12
+ class MemoryStore
13
+ class MultiSink
14
+ class PathChecker
15
+ class PiiRedactor
16
+ class Runner
17
+ class StaticModel
18
+ class StructuredOutput
19
+ class SubagentManager
20
+ class ToolRegistry
21
+ class ToolSelection
22
+ def action
23
+ def after_run
24
+ def allowed?
25
+ def allows?
26
+ def apply
27
+ def apply_interrupt
28
+ def array
29
+ def as_int
30
+ def as_object
31
+ def as_string
32
+ def authorize
33
+ def before_model
34
+ def before_run
35
+ def before_tool
36
+ def bool
37
+ def cancel
38
+ def check
39
+ def check_cancelled
40
+ def check_enum
41
+ def check_keys
42
+ def compact
43
+ def content_block
44
+ def copy
45
+ def decision
46
+ def emit
47
+ def emit_stream
48
+ def equals
49
+ def error
50
+ def error_code
51
+ def estimate_tokens
52
+ def event
53
+ def execute
54
+ def execute_tool
55
+ def extract_json
56
+ def fallback_model
57
+ def filter
58
+ def generate
59
+ def get
60
+ def has?
61
+ def initialize
62
+ def int
63
+ def interrupt
64
+ def interrupt_decision
65
+ def invoke
66
+ def invoke_tool
67
+ def invoke_tools
68
+ def launch
69
+ def marshal
70
+ def memory_record
71
+ def message
72
+ def message_assistant
73
+ def message_text
74
+ def message_tool
75
+ def message_wire
76
+ def parse
77
+ def parse_input_json
78
+ def parse_json_call
79
+ def parse_manifest
80
+ def parse_plain
81
+ def parse_tag
82
+ def parse_toolcall
83
+ def parse_xml
84
+ def plus
85
+ def prepare_tool
86
+ def put
87
+ def redact
88
+ def redact_value
89
+ def register
90
+ def reject
91
+ def request
92
+ def resolve_path
93
+ def response
94
+ def retrieve
95
+ def run
96
+ def run_agent
97
+ def run_result
98
+ def search
99
+ def session
100
+ def set
101
+ def specs
102
+ def stream_part
103
+ def string
104
+ def stringify
105
+ def strip_markup
106
+ def structured_apply
107
+ def text_present
108
+ def timestamp
109
+ def to_wire
110
+ def tool_call
111
+ def tool_spec
112
+ def truncate_to_tokens
113
+ def unmarshal
114
+ def update
115
+ def usage
116
+ def validate
117
+ def visit
118
+ def visit_array
119
+ def visit_boolean
120
+ def visit_number
121
+ def visit_object
122
+ def visit_string
123
+ def wait
124
+ def within?
125
+ module Agent
126
+ module Delegation
127
+ module Json
128
+ module JsonSchema
129
+ module Middleware
130
+ module Models
131
+ module Plugin
132
+ module Praxo
133
+ module Runtime
134
+ module SSE
135
+ module Toolcall
data/api/0.8.2.txt ADDED
@@ -0,0 +1,135 @@
1
+ # PRAXO-CORE Ruby API 0.8.2
2
+ # SPEC_VERSION 0.2.0
3
+
4
+ class AgentOptions
5
+ class CallLimit
6
+ class CheckpointAllowlist
7
+ class ContextBudget
8
+ class Error
9
+ class FilterSink
10
+ class FuncRetriever
11
+ class FuncTool
12
+ class MemoryStore
13
+ class MultiSink
14
+ class PathChecker
15
+ class PiiRedactor
16
+ class Runner
17
+ class StaticModel
18
+ class StructuredOutput
19
+ class SubagentManager
20
+ class ToolRegistry
21
+ class ToolSelection
22
+ def action
23
+ def after_run
24
+ def allowed?
25
+ def allows?
26
+ def apply
27
+ def apply_interrupt
28
+ def array
29
+ def as_int
30
+ def as_object
31
+ def as_string
32
+ def authorize
33
+ def before_model
34
+ def before_run
35
+ def before_tool
36
+ def bool
37
+ def cancel
38
+ def check
39
+ def check_cancelled
40
+ def check_enum
41
+ def check_keys
42
+ def compact
43
+ def content_block
44
+ def copy
45
+ def decision
46
+ def emit
47
+ def emit_stream
48
+ def equals
49
+ def error
50
+ def error_code
51
+ def estimate_tokens
52
+ def event
53
+ def execute
54
+ def execute_tool
55
+ def extract_json
56
+ def fallback_model
57
+ def filter
58
+ def generate
59
+ def get
60
+ def has?
61
+ def initialize
62
+ def int
63
+ def interrupt
64
+ def interrupt_decision
65
+ def invoke
66
+ def invoke_tool
67
+ def invoke_tools
68
+ def launch
69
+ def marshal
70
+ def memory_record
71
+ def message
72
+ def message_assistant
73
+ def message_text
74
+ def message_tool
75
+ def message_wire
76
+ def parse
77
+ def parse_input_json
78
+ def parse_json_call
79
+ def parse_manifest
80
+ def parse_plain
81
+ def parse_tag
82
+ def parse_toolcall
83
+ def parse_xml
84
+ def plus
85
+ def prepare_tool
86
+ def put
87
+ def redact
88
+ def redact_value
89
+ def register
90
+ def reject
91
+ def request
92
+ def resolve_path
93
+ def response
94
+ def retrieve
95
+ def run
96
+ def run_agent
97
+ def run_result
98
+ def search
99
+ def session
100
+ def set
101
+ def specs
102
+ def stream_part
103
+ def string
104
+ def stringify
105
+ def strip_markup
106
+ def structured_apply
107
+ def text_present
108
+ def timestamp
109
+ def to_wire
110
+ def tool_call
111
+ def tool_spec
112
+ def truncate_to_tokens
113
+ def unmarshal
114
+ def update
115
+ def usage
116
+ def validate
117
+ def visit
118
+ def visit_array
119
+ def visit_boolean
120
+ def visit_number
121
+ def visit_object
122
+ def visit_string
123
+ def wait
124
+ def within?
125
+ module Agent
126
+ module Delegation
127
+ module Json
128
+ module JsonSchema
129
+ module Middleware
130
+ module Models
131
+ module Plugin
132
+ module Praxo
133
+ module Runtime
134
+ module SSE
135
+ module Toolcall
data/llms.md CHANGED
@@ -7,12 +7,12 @@
7
7
  ## Package
8
8
 
9
9
  - package: `praxo-core`
10
- - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.7.0)
11
- - source_version: `0.8.0`
12
- - published_version: `0.7.0`
10
+ - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.1)
11
+ - source_version: `0.8.2`
12
+ - published_version: `0.8.1`
13
13
  - install_published: `gem install praxo-core`
14
14
  - install_source: `gem install praxo-core`
15
- - source_tag: `ruby/v0.8.0`
15
+ - source_tag: `ruby/v0.8.2`
16
16
  - tier: Core
17
17
  - contract: `SPEC_VERSION` `0.2.0`
18
18
  - documentation: https://axisvela.github.io/praxo-core/languages/ruby/
@@ -44,8 +44,8 @@
44
44
 
45
45
  ## Boundaries
46
46
 
47
- - In-process framework; not a model provider, hosted service, workflow engine,
48
- identity provider, or safety controller.
47
+ - In-process framework; not an HTTP user agent, crawler, model provider, hosted
48
+ service, workflow engine, identity provider, or safety controller.
49
49
  - No exactly-once, sandbox-isolation, production-security, real-time, or
50
50
  physical-safety claim.
51
51
  - Registry pages are release snapshots. Verify the published version and read the
data/llms.txt CHANGED
@@ -7,12 +7,12 @@
7
7
  # Package
8
8
 
9
9
  - package: `praxo-core`
10
- - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.7.0)
11
- - source_version: `0.8.0`
12
- - published_version: `0.7.0`
10
+ - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.1)
11
+ - source_version: `0.8.2`
12
+ - published_version: `0.8.1`
13
13
  - install_published: `gem install praxo-core`
14
14
  - install_source: `gem install praxo-core`
15
- - source_tag: `ruby/v0.8.0`
15
+ - source_tag: `ruby/v0.8.2`
16
16
  - tier: Core
17
17
  - contract: `SPEC_VERSION` `0.2.0`
18
18
  - documentation: https://axisvela.github.io/praxo-core/languages/ruby/
@@ -44,8 +44,8 @@
44
44
 
45
45
  # Boundaries
46
46
 
47
- - In-process framework; not a model provider, hosted service, workflow engine,
48
- identity provider, or safety controller.
47
+ - In-process framework; not an HTTP user agent, crawler, model provider, hosted
48
+ service, workflow engine, identity provider, or safety controller.
49
49
  - No exactly-once, sandbox-isolation, production-security, real-time, or
50
50
  physical-safety claim.
51
51
  - Registry pages are release snapshots. Verify the published version and read the
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: praxo-core
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.8.0
4
+ version: 0.8.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - AxisVela
@@ -29,6 +29,8 @@ files:
29
29
  - api/0.6.0.txt
30
30
  - api/0.7.0.txt
31
31
  - api/0.8.0.txt
32
+ - api/0.8.1.txt
33
+ - api/0.8.2.txt
32
34
  - lib/praxo.rb
33
35
  - lib/praxo/adapters/anthropic.rb
34
36
  - lib/praxo/adapters/gemini.rb