Repository navigation
Releases
ActingFor 0.1.2
ActingFor 0.1.2
Changes
- Constraint evaluation now uses actual Symbol keys in Context, consistently with Audit sanitization. An ordinary Hash containing both
:amountand"amount"uses the Symbol value for authorization and selected Audit Context. - Getting Started shows how a host-generated
authorization_idcan correlate an authorization AuditEvent with host operation logs throughcontextandaudit_context_keys. This is an application convention, not a new Gem API or schema field. - Public API regression tests cover Context key handling and the interaction with unconstrained Delegations.
Compatibility and limitations
ActiveSupport::HashWithIndifferentAccess stores String keys. A constraint requiring an actual Symbol key therefore does not match that Context in 0.1.2, even if Symbol lookup succeeds. This may change results for applications that relied on the previous behavior. Build an ordinary Hash from trusted, validated host values, for example { amount: product.price }.
The entire Hash is not rejected: an independently matching unconstrained Delegation still participates in authorization. In particular, when a constrained require_approval Delegation stops matching, an unconstrained allow can still result in allow.
Host Authorization remains the host application's responsibility. require_approval is not permission to execute. AuditEvent records authorization, not a guarantee that the business operation committed; authorization_id is neither an idempotency key nor an approval token by itself.
Installation
gem "acting_for", "~> 0.1.2"bundle installNew applications install the Engine migrations with bin/rails acting_for:install:migrations and bin/rails db:migrate. Upgrading from 0.1.1 introduces no schema changes.
Verified environments
- Core CI: Ruby 3.4 / 4.0 × Rails 8.0 / 8.1, all four combinations passed with 355 runs / 910 assertions / 0 failures / 0 errors / 0 skips. RuboCop passed.
- Published Gem: normal RubyGems version installation into a fresh Rails 8.0 application, PostgreSQL 16, Engine migrations and 8 public API / Audit scenarios (85 checks) passed before this GitHub Release was created.
- Supported versions: Ruby >= 3.4 and < 4.1; Rails >= 8.0 and < 8.2.
Artifact identity
- Release date: 2026-11-14
- Release Source:
adce638556e8e8b5a048fbd7241cd9df2808db7b - Tag:
v0.1.2(fixed to the Release Source; later documentation commits do not move this tag) - Gem:
acting_for-0.1.2.gem - Payload: 17 files / 16,384 bytes
- SHA256:
ac2b5ceb93aa3896aab9891bca73424d808629ec3e3109e7fd3d2313f63fdaab - RubyGems metadata and distributed Gem checksum match the pre-publication artifact.
The packaged README is the frozen pre-publication snapshot. Current installation and release documentation is maintained on main after publication.
References
ActingFor 0.1.1
ActingFor 0.1.1
Rails-native delegated authorization for AI agents.
ActingFor 0.1.1 is a backward-compatible patch release adding a stable final authorization reason to ActingFor::Decision.
- RubyGems:
acting_for0.1.1 - Tag:
v0.1.1 - Release Source SHA:
3fdccde58c79e1b0943e22d60016993ab6743835 - Gem size:
16,384 bytes - SHA256:
57ceb266285a0970af79c3ad745171638799b00b6d8617bf9ecfc13382819c29
Install with:
gem "acting_for", "~> 0.1.1"New in 0.1.1
ActingFor::Decision#reason_code exposes the final delegated-authorization reason as a Symbol:
| Decision status | reason_code |
|---|---|
:allow |
:delegation_allowed |
:require_approval |
:delegation_requires_approval |
:deny |
:no_matching_delegation |
Example:
decision = ActingFor.authorize(...)
decision.status
# => :deny
decision.reason_code
# => :no_matching_delegationThe persisted AuditEvent#reason_code keeps its existing String representation, and Authorization now derives it directly from the returned Decision reason so both describe the same final authorization outcome.
Compatibility
0.1.1 does not change:
- the three Decision statuses
allowed?,denied?, orapproval_required?- Delegation matching semantics
- database schema or migrations
- existing AuditEvent reason String values
- supported Ruby / Rails ranges
The new API intentionally exposes only the final Decision reason. It does not expose per-Delegation mismatch details such as expiration, revocation, resource mismatch, or constraint mismatch.
Verification
Before release:
- Ruby 3.4 / Rails 8.0: PASS
- Ruby 3.4 / Rails 8.1: PASS
- Ruby 4.0 / Rails 8.0: PASS
- Ruby 4.0 / Rails 8.1: PASS
- RuboCop: PASS
- representative suite: 351 runs / 898 assertions / 0 failures / 0 errors / 0 skips
- Official Demo candidate integration: 18 runs / 118 assertions / 0 failures / 0 errors / 0 skips
- focused human browser verification: PASS
Published artifact verification:
- RubyGems download: PASS
- distributed size: 16,384 bytes
- distributed SHA256 matches final artifact
- fresh install: PASS
ActingFor::VERSION == "0.1.1": PASS- Rails Engine load: PASS
Responsibility boundary
ActingFor still does not authenticate Agents or execute business operations. The host application remains responsible for authenticating/resolving the Agent and Principal, loading the real Resource, establishing trusted Context, applying its own authorization, and enforcing the returned Decision.
require_approval remains a stop condition, not permission to execute. Approval workflow remains a host responsibility.
Supported environments
| Ruby | Rails | Database |
|---|---|---|
| 3.4 | 8.0 | PostgreSQL 16 |
| 3.4 | 8.1 | PostgreSQL 16 |
| 4.0 | 8.0 | PostgreSQL 16 |
| 4.0 | 8.1 | PostgreSQL 16 |
Repository:
https://github.com/cuichangquan/acting_for
Official Demo:
https://github.com/cuichangquan/acting_for_demo
Licensed under the MIT License.
ActingFor 0.1.0
ActingFor 0.1.0
Rails-native delegated authorization for AI agents.
ActingFor 0.1.0 is the first public release.
- RubyGems:
acting_for0.1.0 - Tag:
v0.1.0 - Source SHA:
6722623a9f24a38c41091e867209bc8f3d913c36 - Gem size:
15,872 bytes - SHA256:
a7c3cfc97bf04445c04b8fc9cbe6be8a9aa433cfb8ba20b0da90f853b1336abd
Install with:
gem "acting_for", "~> 0.1.0"Features
- Local Agent representation with a unique identifier, separate from the host's Principal.
- Persistent Delegations created with
ActingFor.delegate(...), scoped by Principal, Agent, Action, and optional Resource type or instance. ActingFor.authorize(...)returns an immutable Decision with three statuses:allow,deny, andrequire_approval.require_approvalis notallow;allowed?is false.- Constraints support
eq,lt,lte,gt,gte, andin, combined with AND and strict value types. - Optional expiration and idempotent
Delegation#revoke!. - Automatic persisted AuditEvent for every returned authorization Decision, including deny.
- Three Engine migrations installed explicitly through the Rails standard task.
- PostgreSQL 16 support with Rails 8.0 / 8.1 and Ruby 3.4 / 4.0 verified by CI.
Matching require_approval takes precedence over matching allow; no match yields deny.
Installation
Add to your Gemfile:
gem "acting_for", "~> 0.1.0"
# For Rails 8.0, use the JSON compatibility constraint from the verified Quick Start.
gem "json", "< 3"Then run:
bundle install
bin/rails acting_for:install:migrations
bin/rails db:migratePublic API
delegation = ActingFor.delegate(
agent: resolved_agent,
principal: resolved_principal,
action: :purchase,
resource: Product,
constraints: [{ field: "amount", operator: "lte", value: 10_000 }],
effect: :allow,
expires_at: nil
)
decision = ActingFor.authorize(
agent: resolved_agent,
principal: resolved_principal,
action: :purchase,
resource: host_loaded_product,
context: { amount: host_loaded_product.price },
audit_context_keys: [:amount]
)
# decision.status / allowed? / denied? / approval_required?
# delegation.revoke!Host authorization and trust boundaries
The host application remains responsible for:
- authenticating the external Agent
- resolving Agent and Principal records
- loading the real Resource
- verifying trusted Context values
- enforcing the Principal's current host permissions
- executing the actual business operation
Execution should require:
Host Authorization AND ActingFor allow
require_approval stops execution and should enter the host application's approval flow.
Outside v0.1 and known limitations
- Agent authentication, login, session management, and Principal / Agent provisioning belong to the host application.
- ActingFor does not provide an approval workflow, approval UI, notification system, or payment processing.
- ActingFor is not an Agent framework, MCP server, OAuth / OIDC provider, or general-purpose policy engine.
- PostgreSQL is the only officially supported database adapter for v0.1.
- A Decision is the result at authorization time, not a reusable authorization token.
- ActingFor does not guarantee transaction-wide atomicity with the business operation.
Supported environments
| Ruby | Rails | Database |
|---|---|---|
| 3.4 | 8.0 | PostgreSQL 16 |
| 3.4 | 8.1 | PostgreSQL 16 |
| 4.0 | 8.0 | PostgreSQL 16 |
| 4.0 | 8.1 | PostgreSQL 16 |
Documentation
- README
- Getting Started
- Public API
- Security Model
- Responsibility Boundary
- Official Demo
Repository:
https://github.com/cuichangquan/acting_for
Official Demo:
https://github.com/cuichangquan/acting_for_demo
Compatibility and license
This is the first public release, version 0.1.0, tag v0.1.0.
During 0.x, breaking changes may occur, including Public API changes. Review future release notes before upgrading.
Licensed under the MIT License.