praxo-core 0.9.0 → 0.9.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d7c1a76fc89240c8c0c1f0cc941de493594d39e9c76fc6258db5f79d81ebd4fe
4
- data.tar.gz: 48cc44eff38c98873c610c172291144f6d97b69fd781475feddfba28affae1bf
3
+ metadata.gz: 48b4c184a8f2a299c8377e29b835edca0f17d523d9ead7422c2ed06528901f60
4
+ data.tar.gz: f56e6234097eef5ae70f9384207d355b176f780ee85297d4a62aaba6a02e0b2a
5
5
  SHA512:
6
- metadata.gz: e2fdc217fe0a677c92253016bbb50e7f34a25fa1f5e131584aaac5f5554c602e6a6a9855cedf71259d3be04cbbee3df8ec533fbf01ea9bade17bb0619333438c
7
- data.tar.gz: 5f21f6f8ffdcaccfa6e82c033c23dc2ee81b6f22d6cbb02b3be3eba533f00a9c4b89146c4573b964948325d2b13f2a22405ca91454f8247af30276b9576af70f
6
+ metadata.gz: 31cebfc4bb2c015cd2770a34fa0e6a3508dfac0a2a5db0b2afbe74f3c7919acc5eaf277e0fe70055f509b08e229e0a47e72170940779e32419ddd1e3fd7893ea
7
+ data.tar.gz: 465d9ee03b7c6ed7fbac086da7babb98d77ed37025e9461066138f8259829db3e36e65cd43476c37a5397921d2fd0e037f0549bbf0bf3b5a7780494eeadf2777
data/README.md CHANGED
@@ -9,16 +9,33 @@ Use it when an existing Ruby application needs a governed model/tool loop
9
9
  without adding a sidecar in another language. It is not an HTTP user agent,
10
10
  crawler, hosted agent service, or model provider.
11
11
 
12
+ ## Features
13
+
14
+ - A native, dependency-free Ruby agent loop with tool registration and dispatch.
15
+ - Explicit tool scope, policy hooks, final-argument reauthorization, and HITL
16
+ approve, edit, reject, and respond decisions.
17
+ - Typed events, memory, context budgets, middleware, checkpoints, and a JSON
18
+ Schema subset.
19
+ - OpenAI-compatible, Anthropic, and Gemini adapters with SSE streaming; stdio
20
+ MCP, OpenTelemetry, Harmovela, retriever, and synchronous delegation seams.
21
+ - Streaming callbacks, cancellation, bounded parallel tools, and run-scoped call
22
+ limits.
23
+ - An MIT-licensed embedding boundary with no hosted service or provider SDK.
24
+
12
25
  The normative contract is [`spec/`](../../spec/README.md); Go remains the
13
26
  reference implementation.
14
27
 
28
+ ## Package
29
+
15
30
  - `SPEC_VERSION`: `0.2.0`
16
- - Core version: `0.8.2`
31
+ - Core version: `0.9.2`
17
32
  - Tier: core
18
33
  - License: MIT
19
34
  - Dependencies: Ruby standard library only
20
35
  - Ruby source repository: https://github.com/axisvela/praxo-core-ruby
21
- - The latest RubyGems package is `praxo-core@0.8.2`
36
+ - The latest RubyGems package is `praxo-core@0.9.1`
37
+ - `0.9.1` fixes Ruby 3.4 Bundler loading by removing the undeclared `base64`
38
+ dependency
22
39
 
23
40
  ## Registry and Coding-Agent Entry
24
41
 
@@ -26,7 +43,7 @@ reference implementation.
26
43
  - 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)
27
44
  - [Examples](https://github.com/axisvela/praxo-core/tree/main/language/ruby/examples): runnable language-specific examples.
28
45
  - Coding-agent contract: [docs/getting-started/coding-agents.md](https://github.com/axisvela/praxo-core/blob/main/docs/getting-started/coding-agents.md)
29
- - Registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.2)
46
+ - Registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.9.1)
30
47
  - Community: [X](https://x.com/axisvela) · [Weibo](https://weibo.com/u/1936025761)
31
48
 
32
49
  ## Get started
@@ -79,6 +96,19 @@ memory, event, stream, checkpoint, policy, context, middleware, and the agent
79
96
  loop. It also implements human-in-the-loop interrupt decisions, and includes a
80
97
  public API snapshot and a dependency-free test runner.
81
98
 
99
+ ## Limits
100
+
101
+ - Core is an execution framework, not a model provider, hosted agent service,
102
+ crawler, workflow engine, or production sandbox.
103
+ - Checkpoints are recovery hints, not transactions. Core does not provide
104
+ durable execution, exactly-once effects, or an effect ledger.
105
+ - Provider credentials, authentication, retries, rate limits, and durable state
106
+ remain application-owned.
107
+ - The process plugin host uses JSON-Lines over stdio; it is not WASM, container,
108
+ or OS-level isolation.
109
+ - Go remains the reference implementation; full Go feature parity is not
110
+ claimed.
111
+
82
112
  ## Build and test
83
113
 
84
114
  ```bash
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.9.0`, source
4
- tag `ruby/v0.9.0`. Published registry version: `0.8.2`. Registry
3
+ **Status:** published 0.9.1; split source repository; 0.9.2 publication pending. Source version `0.9.2`, source
4
+ tag `ruby/v0.9.2`. Published registry version: `0.9.1`. Registry
5
5
  pages are release snapshots; verify the published version before relying on a
6
6
  feature.
7
7
 
@@ -14,12 +14,12 @@ PRAXO-CORE is an embeddable, MIT-licensed agent framework. This gem is its nativ
14
14
  | Field | Value |
15
15
  | --- | --- |
16
16
  | Package | `praxo-core` |
17
- | Registry | [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.8.2) |
18
- | Source version | `0.9.0` |
19
- | Published registry version | `0.8.2` |
17
+ | Registry | [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.9.1) |
18
+ | Source version | `0.9.2` |
19
+ | Published registry version | `0.9.1` |
20
20
  | Install (published) | `gem install praxo-core` |
21
21
  | Install (source/release prepared) | `gem install praxo-core` |
22
- | Source tag | `ruby/v0.9.0` |
22
+ | Source tag | `ruby/v0.9.2` |
23
23
  | Tier | Core |
24
24
  | Contract | `SPEC_VERSION` `0.2.0` |
25
25
  | Documentation | https://axisvela.github.io/praxo-core/languages/ruby/ |
data/api/0.9.1.txt ADDED
@@ -0,0 +1,146 @@
1
+ # PRAXO-CORE Ruby API 0.9.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 PluginCallError
17
+ class PluginProcessConfig
18
+ class PluginProcessHost
19
+ class Runner
20
+ class StaticModel
21
+ class StructuredOutput
22
+ class SubagentManager
23
+ class ToolRegistry
24
+ class ToolSelection
25
+ def action
26
+ def active?
27
+ def after_run
28
+ def allowed?
29
+ def allows?
30
+ def apply
31
+ def apply_interrupt
32
+ def array
33
+ def as_int
34
+ def as_object
35
+ def as_string
36
+ def authorize
37
+ def before_model
38
+ def before_run
39
+ def before_tool
40
+ def bool
41
+ def call
42
+ def cancel
43
+ def check
44
+ def check_cancelled
45
+ def check_enum
46
+ def check_keys
47
+ def compact
48
+ def content_block
49
+ def copy
50
+ def decision
51
+ def emit
52
+ def emit_stream
53
+ def equals
54
+ def error
55
+ def error_code
56
+ def estimate_tokens
57
+ def event
58
+ def execute
59
+ def execute_tool
60
+ def extract_json
61
+ def fallback_model
62
+ def filter
63
+ def generate
64
+ def get
65
+ def has?
66
+ def initialize
67
+ def int
68
+ def interrupt
69
+ def interrupt_decision
70
+ def invoke
71
+ def invoke_tool
72
+ def invoke_tools
73
+ def launch
74
+ def marshal
75
+ def memory_record
76
+ def message
77
+ def message_assistant
78
+ def message_text
79
+ def message_tool
80
+ def message_wire
81
+ def parse
82
+ def parse_input_json
83
+ def parse_json_call
84
+ def parse_manifest
85
+ def parse_plain
86
+ def parse_response
87
+ def parse_tag
88
+ def parse_toolcall
89
+ def parse_xml
90
+ def plus
91
+ def prepare_tool
92
+ def put
93
+ def redact
94
+ def redact_value
95
+ def register
96
+ def reject
97
+ def request
98
+ def resolve_path
99
+ def response
100
+ def retrieve
101
+ def run
102
+ def run_agent
103
+ def run_result
104
+ def search
105
+ def send_cancel
106
+ def session
107
+ def set
108
+ def specs
109
+ def start
110
+ def stderr_text
111
+ def stop
112
+ def stream_part
113
+ def string
114
+ def stringify
115
+ def strip_markup
116
+ def structured_apply
117
+ def terminate
118
+ def text_present
119
+ def timestamp
120
+ def to_wire
121
+ def tool_call
122
+ def tool_spec
123
+ def truncate_to_tokens
124
+ def unmarshal
125
+ def update
126
+ def usage
127
+ def validate
128
+ def visit
129
+ def visit_array
130
+ def visit_boolean
131
+ def visit_number
132
+ def visit_object
133
+ def visit_string
134
+ def wait
135
+ def within?
136
+ module Agent
137
+ module Delegation
138
+ module Json
139
+ module JsonSchema
140
+ module Middleware
141
+ module Models
142
+ module Plugin
143
+ module Praxo
144
+ module Runtime
145
+ module SSE
146
+ module Toolcall
data/api/0.9.2.txt ADDED
@@ -0,0 +1,146 @@
1
+ # PRAXO-CORE Ruby API 0.9.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 PluginCallError
17
+ class PluginProcessConfig
18
+ class PluginProcessHost
19
+ class Runner
20
+ class StaticModel
21
+ class StructuredOutput
22
+ class SubagentManager
23
+ class ToolRegistry
24
+ class ToolSelection
25
+ def action
26
+ def active?
27
+ def after_run
28
+ def allowed?
29
+ def allows?
30
+ def apply
31
+ def apply_interrupt
32
+ def array
33
+ def as_int
34
+ def as_object
35
+ def as_string
36
+ def authorize
37
+ def before_model
38
+ def before_run
39
+ def before_tool
40
+ def bool
41
+ def call
42
+ def cancel
43
+ def check
44
+ def check_cancelled
45
+ def check_enum
46
+ def check_keys
47
+ def compact
48
+ def content_block
49
+ def copy
50
+ def decision
51
+ def emit
52
+ def emit_stream
53
+ def equals
54
+ def error
55
+ def error_code
56
+ def estimate_tokens
57
+ def event
58
+ def execute
59
+ def execute_tool
60
+ def extract_json
61
+ def fallback_model
62
+ def filter
63
+ def generate
64
+ def get
65
+ def has?
66
+ def initialize
67
+ def int
68
+ def interrupt
69
+ def interrupt_decision
70
+ def invoke
71
+ def invoke_tool
72
+ def invoke_tools
73
+ def launch
74
+ def marshal
75
+ def memory_record
76
+ def message
77
+ def message_assistant
78
+ def message_text
79
+ def message_tool
80
+ def message_wire
81
+ def parse
82
+ def parse_input_json
83
+ def parse_json_call
84
+ def parse_manifest
85
+ def parse_plain
86
+ def parse_response
87
+ def parse_tag
88
+ def parse_toolcall
89
+ def parse_xml
90
+ def plus
91
+ def prepare_tool
92
+ def put
93
+ def redact
94
+ def redact_value
95
+ def register
96
+ def reject
97
+ def request
98
+ def resolve_path
99
+ def response
100
+ def retrieve
101
+ def run
102
+ def run_agent
103
+ def run_result
104
+ def search
105
+ def send_cancel
106
+ def session
107
+ def set
108
+ def specs
109
+ def start
110
+ def stderr_text
111
+ def stop
112
+ def stream_part
113
+ def string
114
+ def stringify
115
+ def strip_markup
116
+ def structured_apply
117
+ def terminate
118
+ def text_present
119
+ def timestamp
120
+ def to_wire
121
+ def tool_call
122
+ def tool_spec
123
+ def truncate_to_tokens
124
+ def unmarshal
125
+ def update
126
+ def usage
127
+ def validate
128
+ def visit
129
+ def visit_array
130
+ def visit_boolean
131
+ def visit_number
132
+ def visit_object
133
+ def visit_string
134
+ def wait
135
+ def within?
136
+ module Agent
137
+ module Delegation
138
+ module Json
139
+ module JsonSchema
140
+ module Middleware
141
+ module Models
142
+ module Plugin
143
+ module Praxo
144
+ module Runtime
145
+ module SSE
146
+ module Toolcall
@@ -1,4 +1,3 @@
1
- require 'base64'
2
1
  require 'json'
3
2
  require 'open3'
4
3
  require 'securerandom'
@@ -147,7 +146,7 @@ module Praxo
147
146
  'service' => service,
148
147
  'method' => method,
149
148
  'token' => @token,
150
- 'payload' => Base64.strict_encode64(payload.to_s)
149
+ 'payload' => [payload.to_s].pack('m0')
151
150
  }
152
151
  encoded = "#{JSON.generate(frame)}\n"
153
152
  raise PluginCallError.new('INVALID_REQUEST', 'plugin: request frame too large') if encoded.bytesize > config.max_frame
@@ -185,7 +184,7 @@ module Praxo
185
184
  raise PluginCallError.new(response['code'] || 'INTERNAL', response['message'] || '')
186
185
  end
187
186
  begin
188
- return Base64.strict_decode64(response['payload'] || '')
187
+ return (response['payload'] || '').unpack1('m0')
189
188
  rescue ArgumentError
190
189
  raise PluginCallError.new('INTERNAL', 'plugin: invalid payload')
191
190
  end
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.8.2)
11
- - source_version: `0.9.0`
12
- - published_version: `0.8.2`
10
+ - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.9.1)
11
+ - source_version: `0.9.2`
12
+ - published_version: `0.9.1`
13
13
  - install_published: `gem install praxo-core`
14
14
  - install_source: `gem install praxo-core`
15
- - source_tag: `ruby/v0.9.0`
15
+ - source_tag: `ruby/v0.9.2`
16
16
  - tier: Core
17
17
  - contract: `SPEC_VERSION` `0.2.0`
18
18
  - documentation: https://axisvela.github.io/praxo-core/languages/ruby/
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.8.2)
11
- - source_version: `0.9.0`
12
- - published_version: `0.8.2`
10
+ - registry: [RubyGems](https://rubygems.org/gems/praxo-core/versions/0.9.1)
11
+ - source_version: `0.9.2`
12
+ - published_version: `0.9.1`
13
13
  - install_published: `gem install praxo-core`
14
14
  - install_source: `gem install praxo-core`
15
- - source_tag: `ruby/v0.9.0`
15
+ - source_tag: `ruby/v0.9.2`
16
16
  - tier: Core
17
17
  - contract: `SPEC_VERSION` `0.2.0`
18
18
  - documentation: https://axisvela.github.io/praxo-core/languages/ruby/
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.9.0
4
+ version: 0.9.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - AxisVela
@@ -9,8 +9,9 @@ bindir: bin
9
9
  cert_chain: []
10
10
  date: 1980-01-02 00:00:00.000000000 Z
11
11
  dependencies: []
12
- description: 'Native Ruby Core for the PRAXO-CORE agent framework: tools, policy,
13
- events, memory, context, middleware, checkpoints, and an agent loop.'
12
+ description: 'Native Ruby Core for PRAXO-CORE: a dependency-free agent loop with governed
13
+ tool calls, policy and HITL decisions, events, memory, context, middleware, checkpoints,
14
+ streaming OpenAI-compatible/Anthropic/Gemini adapters, MCP, OpenTelemetry, and delegation.'
14
15
  email:
15
16
  - releases@axisvela.com
16
17
  executables: []
@@ -32,6 +33,8 @@ files:
32
33
  - api/0.8.1.txt
33
34
  - api/0.8.2.txt
34
35
  - api/0.9.0.txt
36
+ - api/0.9.1.txt
37
+ - api/0.9.2.txt
35
38
  - lib/praxo.rb
36
39
  - lib/praxo/adapters/anthropic.rb
37
40
  - lib/praxo/adapters/gemini.rb
@@ -78,5 +81,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
78
81
  requirements: []
79
82
  rubygems_version: 3.6.9
80
83
  specification_version: 4
81
- summary: Embeddable MIT-licensed agent framework for Ruby
84
+ summary: Embeddable, policy-governed AI agent framework for Ruby
82
85
  test_files: []