ask-session-protocol 0.2.0

data/lib/ask/session_protocol.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Ask
+  # ask-session-protocol — the canonical wire contract between the ask
+  # session host (ask-app-server) and every client: terminal TUI, web
+  # console, bots, IDE integrations.
+  #
+  # This gem is a definition, not an implementation. It contains no runtime,
+  # no transports, and no session logic. It is the single authoritative,
+  # versioned artifact for what a session event looks like on the wire and
+  # which methods a host exposes — so the host and every client evolve
+  # independently against the same contract.
+  module SessionProtocol
+    # Wire protocol version, negotiated in the `initialize` handshake.
+    # Semantic: bump the minor on additive changes (new events, new
+    # methods), bump the major on breaking changes. Clients must tolerate
+    # unknown event types and methods within the same major version.
+    PROTOCOL_VERSION = "1.0"
+
+    # How a subscriber receives events for a session.
+    #
+    #   live                — events are pushed as they happen; no replay
+    #   replay              — the host replays the session's event log
+    #                         from after_seq before pushing new events
+    #   web-remote-replayable — replay semantics tuned for web/remote
+    #                         clients (snapshot-friendly, resumable)
+    DELIVERY_KINDS = %w[live replay web-remote-replayable].freeze
+  end
+end
+
+require_relative "session_protocol/version"
+require_relative "session_protocol/events"
+require_relative "session_protocol/interactions"
+require_relative "session_protocol/methods"
+require_relative "session_protocol/schema"
+require_relative "session_protocol/client"
+require_relative "session_protocol/host"

data/lib/ask-session-protocol.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ask/session_protocol"

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: ask-session-protocol
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: The contract between the ask session host and every client (terminal
+  TUI, web console, bots, IDE) — plus the shared Client and Host. Defines the canonical
+  session event vocabulary, the resolvable interaction types (approvals, plan proposals,
+  user input), the client-to-host method surface, protocol versioning, and generated
+  JSON Schema artifacts. No runtime, no transports — just the contract.
+email:
+- kaka@myrrlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- docs/ask-session-protocol.schema.json
+- lib/ask-session-protocol.rb
+- lib/ask/session_protocol.rb
+- lib/ask/session_protocol/client.rb
+- lib/ask/session_protocol/events.rb
+- lib/ask/session_protocol/host.rb
+- lib/ask/session_protocol/interactions.rb
+- lib/ask/session_protocol/methods.rb
+- lib/ask/session_protocol/schema.rb
+- lib/ask/session_protocol/version.rb
+homepage: https://github.com/ask-rb/ask-session-protocol
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.18
+specification_version: 4
+summary: The canonical wire protocol for ask agent sessions
+test_files: []