Ajay Krishnan
889d38332f
opencode-ruby — idiomatic Ruby client for OpenCode (HTTP + SSE). Hand-rolled, opinionated Ruby SDK with block-form streaming, value- object responses, and automatic SSE reconnection. Pluggable Opencode::Instrumentation adapter for routing events to ActiveSupport::Notifications, OpenTelemetry, stdout, or any custom emitter. Companion to opencode-rails for AR-coupled Rails apps. What this version ships: - Opencode::Client (Net::HTTP + SSE) - Opencode::Reply / Reply::Result / ReplyObserver - Opencode::Tracer, Opencode::Prompts - Opencode::ResponseParser, ToolPart, PartSource, Todo - Opencode::Instrumentation (instrument + notify) - Opencode::Error and seven subclasses - examples/conversation_recipe.rb — canonical Rails wiring blueprint 15 smoke tests. CI on Ruby 3.2/3.3/3.4. Ruby >= 3.2. Runtime dep: activesupport >= 6.1, < 9.0. See CHANGELOG.md for the alpha1 -> alpha2 delta.
44 lines
1.5 KiB
Ruby
44 lines
1.5 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
module Opencode
|
|
# One todo item the OpenCode `todowrite` tool and `todo.updated` bus
|
|
# event carry: `content` + `status` + (optional) `priority`.
|
|
# Source-of-truth canonicalization lives here so Reply, ToolDisplay,
|
|
# and any future consumer all share one definition of "what does this
|
|
# todo look like once we've normalized it."
|
|
#
|
|
# Status canonicalization: OpenCode bus events have been observed
|
|
# emitting the hyphenated `"in-progress"` form. The rest of the
|
|
# codebase (per-product views, todowrite tool input shape per the
|
|
# v1.15+ openapi spec) uses the underscored `"in_progress"`.
|
|
# Canonicalize to underscore at every entry point so downstream code
|
|
# never has to handle both.
|
|
module Todo
|
|
HYPHENATED_TO_CANONICAL_STATUS = {
|
|
"in-progress" => "in_progress"
|
|
}.freeze
|
|
|
|
module_function
|
|
|
|
def canonical_status(status)
|
|
raw = status.to_s
|
|
HYPHENATED_TO_CANONICAL_STATUS.fetch(raw) { raw.tr("-", "_") }
|
|
end
|
|
|
|
# Canonicalize one todo hash: string-keyed, normalized status.
|
|
# Returns the input unchanged when it isn't a Hash (the substrate
|
|
# tolerates wire-shape drift defensively).
|
|
def canonicalize(todo)
|
|
return todo unless todo.is_a?(Hash)
|
|
|
|
result = todo.deep_stringify_keys
|
|
result["status"] = canonical_status(result["status"]) if result.key?("status")
|
|
result
|
|
end
|
|
|
|
def canonicalize_all(todos)
|
|
Array(todos).map { |t| canonicalize(t) }
|
|
end
|
|
end
|
|
end
|