layered-assistant-rails 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c87ef1f390a6a4c102682cb4befebc1950f8566552f5213075a9d9f2ac4c7b49
-  data.tar.gz: 0d289b5e1f05d1f696ae8e37053ec75b51b3bf3c280091ceb33d836c0f06678b
+  metadata.gz: 801e95c2e899ba36085052a8971f405f2a7d5b12f3129193cf738978d0653c2c
+  data.tar.gz: b9fefa9325aaf76a334d7f958a37cdf119f73f59bddf08cfbd77b20a62ffddcd
 SHA512:
-  metadata.gz: 68cb5c184761c2ef7de4bf43cc6b84a32dfbe2b8cfd434cb3562c72265e7d9640bd3ad41f965a1c4cc04fec13c02b314cacf5780e1d779f2d08fec87aefa260a
-  data.tar.gz: 8f9cc996f9de499fa6d7c9afaf8f607eed0ea9c06c0f78f3e2ff8aeac67580a8a897002c0b5c350c668d76920311c9c2cbae10c2d11b452b99cd89a3c9c70533
+  metadata.gz: cff5a257d775b91f808b1b92cf52a5c9f25be2fe5885edb8557b074c6994f1d664645807c783464552f0b409e7115f65e598fde7618b90f5f34b29c8b8d48dc7
+  data.tar.gz: 5e7bf84dafd4756af9bfa208a9711a16411a7543e7bc3b657e56f591643d2d9e748bb32b80cf8bbc3fc469a719ec79382b95847f30dd1ef13926bb8b71c672fd

data/.claude/skills/layered-assistant-rails/SKILL.md

@@ -27,12 +27,14 @@ The install generator:
 
 1. Verifies `layered-ui-rails` is installed - invokes its installer if not.
 2. Adds `import "layered_assistant"` to `app/javascript/application.js` (after the `layered_ui` import).
-3. Creates `config/initializers/layered_assistant.rb` with example `authorize` and `scope` blocks.
+3. Creates `config/initializers/layered_assistant.rb` with example `authorize` blocks, notes on record ownership with an optional `owner` block, and tool configuration examples.
 4. Mounts the engine at `/layered/assistant` in `config/routes.rb`.
 5. Copies migrations into the host app via the `layered:assistant:migrations` generator.
 
 After installation, configure the initializer (see below) - **routes return 403 until an `authorize` block is set**. Then visit `/layered/assistant` to set up providers, models, personas, skills and assistants.
 
+**Streaming:** replies are generated in an Active Job and broadcast as Turbo Streams over Action Cable. The queue adapter must run jobs in the background (not `:inline`), and if jobs run in a separate worker process (Solid Queue's `bin/jobs`, Sidekiq), `config/cable.yml` must use `solid_cable` or `redis` rather than `async`. The Rails defaults (`:async` jobs, `async` cable) work in a single development process.
+
 ## Authorization
 
 All non-public engine routes are gated by an `authorize` block. The block runs in controller context, so you have access to `current_user`, `request`, `redirect_to`, `head`, `main_app`, etc.
@@ -229,6 +231,7 @@ The engine renders inside `layered-ui-rails` layouts and uses only `l-ui-` class
 - **Provider creation fails with encryption error** - run `bin/rails db:encryption:init` and add the keys to credentials, or set `Layered::Assistant.skip_db_encryption = true` for dev/test.
 - **Panel body never loads** - `turbo-rails` must be installed and `layered-ui-rails` must be mounted in the layout. Check `import "@hotwired/turbo-rails"` is present.
 - **`layered_assistant` JS controllers missing** - ensure `import "layered_assistant"` is in `app/javascript/application.js` (added by the install generator, after the `layered_ui` import).
+- **Replies don't stream, or only appear after a refresh** - the job's broadcasts aren't reaching the browser. Avoid the `:inline` queue adapter, and if jobs run in a separate worker, switch `config/cable.yml` from `async` to `solid_cable` or `redis`.
 - **No records visible, or `MissingOwnerError` on create** - `current_owner` is nil. Check the authorize block only admits signed-in users, and that any `Layered::Assistant.owner` block returns a record.
 
 ## Further reference

data/README.md

@@ -76,6 +76,22 @@ bin/rails generate layered:assistant:migrations
 bin/rails db:migrate
 ```
 
+### Background jobs and Action Cable
+
+Assistant replies are generated in an Active Job and streamed to the browser
+as Turbo Streams over Action Cable. Streaming needs two things from the host
+app:
+
+- **A queue adapter that runs jobs in the background.** With `:inline`, the job
+  runs inside the request that sent the message, so the whole reply arrives at
+  once instead of streaming. The Rails default (`:async`) and Solid Queue both
+  work.
+- **A cable adapter the job process can reach.** The `async` cable adapter only
+  works within one process. It is fine when jobs also run in the web process
+  (the `:async` queue adapter), but if jobs run in a separate worker (Solid
+  Queue's `bin/jobs`, Sidekiq, etc.), their broadcasts never reach the browser.
+  Use `solid_cable` or `redis` in `config/cable.yml` instead.
+
 ## Authorization
 
 All non-public engine routes are **blocked by default** (403 Forbidden) until you configure an `authorize` block. The install generator creates a starter initialiser at `config/initializers/layered_assistant.rb` - uncomment one of the examples to get started.

data/app/models/layered/assistant/conversation.rb

@@ -3,8 +3,10 @@ module Layered
     class Conversation < ApplicationRecord
       include Ownable
 
-      # UID
-      has_secure_token :uid
+      # UID: the public identifier, in the form conversation_<uuid>
+      UID_FORMAT = /\Aconversation_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/
+
+      attribute :uid, :string, default: -> { "conversation_#{SecureRandom.uuid}" }
 
       # Associations
       belongs_to :assistant, counter_cache: true
@@ -22,6 +24,7 @@ module Layered
 
       # Validations
       validates :name, presence: true
+      validates :uid, format: { with: UID_FORMAT }, uniqueness: true
 
       # Scopes
       scope :by_name, -> { order(name: :asc, created_at: :desc) }

data/db/migrate/20261031000000_prefix_layered_assistant_conversation_uids.rb

@@ -0,0 +1,14 @@
+class PrefixLayeredAssistantConversationUids < ActiveRecord::Migration[8.0]
+  # Conversation uids become conversation_<uuid>. Existing tokens are
+  # replaced, so old conversation URLs stop resolving; the integer primary
+  # key is untouched.
+  def up
+    select_values("SELECT id FROM layered_assistant_conversations").each do |id|
+      execute "UPDATE layered_assistant_conversations SET uid = #{quote("conversation_#{SecureRandom.uuid}")} WHERE id = #{id.to_i}"
+    end
+  end
+
+  def down
+    # Irreversible data change; the prefixed uids remain valid.
+  end
+end

data/lib/layered/assistant/version.rb

@@ -1,5 +1,5 @@
 module Layered
   module Assistant
-    VERSION = "0.9.1"
+    VERSION = "0.10.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: layered-assistant-rails
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - layered.ai
@@ -427,6 +427,7 @@ files:
 - db/migrate/20260901000000_create_layered_assistant_assistant_tools.rb
 - db/migrate/20260901000001_add_user_to_layered_assistant_conversations.rb
 - db/migrate/20260919000000_add_tool_status_to_layered_assistant_messages.rb
+- db/migrate/20261031000000_prefix_layered_assistant_conversation_uids.rb
 - lib/generators/layered/assistant/install_agent_skill_generator.rb
 - lib/generators/layered/assistant/install_generator.rb
 - lib/generators/layered/assistant/migrations_generator.rb