durable_agent 0.1.0

data/sidecar/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "durable-agent-sidecar",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "durable_agent sidecar: the pi-durable runtime, storing its state in the Rails app's database (Postgres or SQLite).",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "dev": "node --watch --env-file-if-exists=.env src/main.ts",
+    "start": "node --env-file-if-exists=.env src/main.ts",
+    "build": "esbuild src/main.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/sidecar.js --legal-comments=none \"--banner:js=import { createRequire as __durableAgentCreateRequire } from 'node:module'; const require = __durableAgentCreateRequire(import.meta.url);\"",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --test-concurrency=1 test/",
+    "test:postgres": "DURABLE_AGENT_TEST_DATABASE_URL=${DURABLE_AGENT_TEST_DATABASE_URL:-postgres://localhost/durable_agent_sidecar_test} node --test --test-concurrency=1 test/"
+  },
+  "dependencies": {
+    "@earendil-works/chord": "1.3.0",
+    "@earendil-works/pi-ai": "1.3.0",
+    "@earendil-works/pi-durable": "1.3.0",
+    "@hono/node-server": "^1.14.0",
+    "hono": "^4.7.0",
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/pg": "^8.11.0",
+    "esbuild": "0.28.2",
+    "typescript": "^5.8.0"
+  }
+}

data/sidecar/sql/schema.postgres.sql

@@ -0,0 +1,120 @@
+-- durable_agent schema v2 for Postgres: a hand rendering of the gem's install migration
+-- (lib/generators/durable_agent/install/templates/create_durable_agent_tables.rb.tt) for the sidecar tests.
+-- Rails owns the real schema; test/lib/durable_agent/sidecar_schema_test.rb runs both against fresh databases and
+-- compares tables, column types, nullability and defaults, and index definitions.
+-- The first nine tables are pi-durable 1.3.0's schema (version 1) under the durable_agent_ prefix, minus STRICT
+-- and the json_valid checks. No rows: the sidecar seeds the singletons at boot.
+
+CREATE TABLE IF NOT EXISTS durable_agent_durable_schema (
+  singleton bigserial PRIMARY KEY,
+  version integer NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_durable_metadata (
+  singleton bigserial PRIMARY KEY,
+  next_id text NOT NULL,
+  next_seq bigint NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_record_ids (
+  id bigserial PRIMARY KEY,
+  record_type text NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_conversations (
+  id bigserial PRIMARY KEY,
+  owner_conversation_id bigint,
+  owner_task_id bigint,
+  record text NOT NULL,
+  created_at timestamp(6) without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_conversations_by_owner_conversation ON durable_agent_conversations (owner_conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_conversations_by_owner_task ON durable_agent_conversations (owner_task_id, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_entries (
+  id bigserial PRIMARY KEY,
+  conversation_id bigint NOT NULL,
+  head bigint,
+  commit_seq bigint NOT NULL,
+  record text NOT NULL,
+  created_at timestamp(6) without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_entries_by_conversation ON durable_agent_entries (conversation_id, id DESC);
+CREATE INDEX IF NOT EXISTS durable_agent_entry_heads_by_conversation ON durable_agent_entries (conversation_id, id DESC) WHERE head IS NOT NULL;
+
+CREATE TABLE IF NOT EXISTS durable_agent_tasks (
+  id bigserial PRIMARY KEY,
+  conversation_id bigint NOT NULL,
+  kind text NOT NULL,
+  status text NOT NULL,
+  abort_requested integer NOT NULL,
+  background integer NOT NULL,
+  record text NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_status ON durable_agent_tasks (status, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_conversation ON durable_agent_tasks (conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_kind ON durable_agent_tasks (kind, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_abort_requested ON durable_agent_tasks (abort_requested, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_background ON durable_agent_tasks (background, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_submissions (
+  id bigserial PRIMARY KEY,
+  conversation_id bigint NOT NULL,
+  request_id text,
+  status text NOT NULL,
+  record text NOT NULL,
+  created_at timestamp(6) without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_request ON durable_agent_submissions (conversation_id, request_id);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_conversation ON durable_agent_submissions (conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_status ON durable_agent_submissions (status, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_documents (
+  id bigserial PRIMARY KEY,
+  kind text NOT NULL,
+  family integer NOT NULL,
+  key_value text NOT NULL,
+  scope_kind text NOT NULL,
+  owner_id bigint NOT NULL,
+  created_at bigint NOT NULL,
+  retired_at bigint,
+  record text NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_address ON durable_agent_documents (kind, scope_kind, owner_id, family, key_value, created_at DESC, retired_at);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_scope ON durable_agent_documents (scope_kind, owner_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_scope_kind ON durable_agent_documents (scope_kind, owner_id, kind, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_document_revisions (
+  document_id bigint NOT NULL,
+  seq bigint NOT NULL,
+  kind text NOT NULL,
+  version bigint NOT NULL,
+  content text NOT NULL,
+  PRIMARY KEY (document_id, seq)
+);
+CREATE INDEX IF NOT EXISTS durable_agent_document_revisions_by_kind ON durable_agent_document_revisions (document_id, kind, seq DESC);
+
+CREATE TABLE IF NOT EXISTS durable_agent_reports (
+  id bigserial PRIMARY KEY,
+  type text NOT NULL,
+  conversation_id bigint,
+  task_id bigint,
+  task_kind text,
+  extension text,
+  message text NOT NULL,
+  info text NOT NULL,
+  created_at timestamp(6) without time zone NOT NULL
+);
+CREATE INDEX IF NOT EXISTS index_durable_agent_reports_on_conversation_id_and_id ON durable_agent_reports (conversation_id, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_credentials (
+  provider_id text PRIMARY KEY,
+  credential text NOT NULL,
+  updated_at timestamp(6) without time zone NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_settings (
+  key text PRIMARY KEY,
+  value text NOT NULL,
+  updated_at timestamp(6) without time zone NOT NULL
+);

data/sidecar/sql/schema.sqlite.sql

@@ -0,0 +1,120 @@
+-- durable_agent schema v2 for SQLite: a hand rendering of the gem's install migration
+-- (lib/generators/durable_agent/install/templates/create_durable_agent_tables.rb.tt) for the sidecar tests.
+-- Rails owns the real schema; test/lib/durable_agent/sidecar_schema_test.rb runs both against fresh databases and
+-- compares tables, column types, nullability and defaults, and index definitions.
+-- The first nine tables are pi-durable 1.3.0's schema (version 1) under the durable_agent_ prefix, minus STRICT
+-- and the json_valid checks. No rows: the sidecar seeds the singletons at boot.
+
+CREATE TABLE IF NOT EXISTS durable_agent_durable_schema (
+  singleton integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  version integer NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_durable_metadata (
+  singleton integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  next_id text NOT NULL,
+  next_seq bigint NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_record_ids (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  record_type text NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_conversations (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  owner_conversation_id bigint,
+  owner_task_id bigint,
+  record text NOT NULL,
+  created_at datetime(6) DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_conversations_by_owner_conversation ON durable_agent_conversations (owner_conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_conversations_by_owner_task ON durable_agent_conversations (owner_task_id, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_entries (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  conversation_id bigint NOT NULL,
+  head bigint,
+  commit_seq bigint NOT NULL,
+  record text NOT NULL,
+  created_at datetime(6) DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_entries_by_conversation ON durable_agent_entries (conversation_id, id DESC);
+CREATE INDEX IF NOT EXISTS durable_agent_entry_heads_by_conversation ON durable_agent_entries (conversation_id, id DESC) WHERE head IS NOT NULL;
+
+CREATE TABLE IF NOT EXISTS durable_agent_tasks (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  conversation_id bigint NOT NULL,
+  kind text NOT NULL,
+  status text NOT NULL,
+  abort_requested integer NOT NULL,
+  background integer NOT NULL,
+  record text NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_status ON durable_agent_tasks (status, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_conversation ON durable_agent_tasks (conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_kind ON durable_agent_tasks (kind, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_abort_requested ON durable_agent_tasks (abort_requested, id);
+CREATE INDEX IF NOT EXISTS durable_agent_tasks_by_background ON durable_agent_tasks (background, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_submissions (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  conversation_id bigint NOT NULL,
+  request_id text,
+  status text NOT NULL,
+  record text NOT NULL,
+  created_at datetime(6) DEFAULT CURRENT_TIMESTAMP NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_request ON durable_agent_submissions (conversation_id, request_id);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_conversation ON durable_agent_submissions (conversation_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_submissions_by_status ON durable_agent_submissions (status, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_documents (
+  id integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+  kind text NOT NULL,
+  family integer NOT NULL,
+  key_value text NOT NULL,
+  scope_kind text NOT NULL,
+  owner_id bigint NOT NULL,
+  created_at bigint NOT NULL,
+  retired_at bigint,
+  record text NOT NULL
+);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_address ON durable_agent_documents (kind, scope_kind, owner_id, family, key_value, created_at DESC, retired_at);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_scope ON durable_agent_documents (scope_kind, owner_id, id);
+CREATE INDEX IF NOT EXISTS durable_agent_documents_by_scope_kind ON durable_agent_documents (scope_kind, owner_id, kind, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_document_revisions (
+  document_id bigint NOT NULL,
+  seq bigint NOT NULL,
+  kind text NOT NULL,
+  version bigint NOT NULL,
+  content text NOT NULL,
+  PRIMARY KEY (document_id, seq)
+);
+CREATE INDEX IF NOT EXISTS durable_agent_document_revisions_by_kind ON durable_agent_document_revisions (document_id, kind, seq DESC);
+
+CREATE TABLE IF NOT EXISTS durable_agent_reports (
+  id integer NOT NULL PRIMARY KEY AUTOINCREMENT,
+  type text NOT NULL,
+  conversation_id bigint,
+  task_id bigint,
+  task_kind text,
+  extension text,
+  message text NOT NULL,
+  info text NOT NULL,
+  created_at datetime(6) NOT NULL
+);
+CREATE INDEX IF NOT EXISTS index_durable_agent_reports_on_conversation_id_and_id ON durable_agent_reports (conversation_id, id);
+
+CREATE TABLE IF NOT EXISTS durable_agent_credentials (
+  provider_id text NOT NULL PRIMARY KEY,
+  credential text NOT NULL,
+  updated_at datetime(6) NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS durable_agent_settings (
+  key text NOT NULL PRIMARY KEY,
+  value text NOT NULL,
+  updated_at datetime(6) NOT NULL
+);

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: durable_agent
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mikkel Malmberg
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Crash-safe, resumable agent conversations for Rails. Ships the pi-durable
+  runtime as a sidecar process inside the gem that keeps its state in your app's database,
+  Postgres or SQLite, which Rails reads with Active Record. Broadcasts over Turbo,
+  and lets you write tools in Ruby.
+email:
+- mikkel@brnbw.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- DESIGN.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/durable_agent/application_controller.rb
+- app/controllers/durable_agent/events_controller.rb
+- app/controllers/durable_agent/tools_controller.rb
+- app/models/concerns/durable_agent/harness_record.rb
+- app/models/durable_agent/application_record.rb
+- app/models/durable_agent/connection.rb
+- app/models/durable_agent/conversation.rb
+- app/models/durable_agent/document.rb
+- app/models/durable_agent/document/revision.rb
+- app/models/durable_agent/entry.rb
+- app/models/durable_agent/report.rb
+- app/models/durable_agent/submission.rb
+- app/models/durable_agent/task.rb
+- config/routes.rb
+- docs/guide.md
+- lib/durable_agent.rb
+- lib/durable_agent/account.rb
+- lib/durable_agent/client.rb
+- lib/durable_agent/configuration.rb
+- lib/durable_agent/current.rb
+- lib/durable_agent/engine.rb
+- lib/durable_agent/indexed_string.rb
+- lib/durable_agent/message_text.rb
+- lib/durable_agent/sidecar.rb
+- lib/durable_agent/test_helper.rb
+- lib/durable_agent/tool.rb
+- lib/durable_agent/version.rb
+- lib/generators/durable_agent/install/install_generator.rb
+- lib/generators/durable_agent/install/templates/create_durable_agent_tables.rb.tt
+- lib/generators/durable_agent/install/templates/durable_agent.rb.tt
+- lib/tasks/durable_agent_tasks.rake
+- sidecar/dist/sidecar.js
+- sidecar/package.json
+- sidecar/sql/schema.postgres.sql
+- sidecar/sql/schema.sqlite.sql
+homepage: https://github.com/mikker/durable_agent
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mikker/durable_agent
+  source_code_uri: https://github.com/mikker/durable_agent
+  changelog_uri: https://github.com/mikker/durable_agent/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: 'A durable AI agent runtime for Rails: pi-durable as a bundled sidecar, in
+  your own database.'
+test_files: []