lingara 0.2.0.pre.alpha.4 → 0.2.0.pre.alpha.6

data/lib/lingara/operations.rb

@@ -6,6 +6,42 @@ module Lingara
   # is its terminal table: :yield (yielded, then the stream ends), :quiet
   # (a Done payload, never yielded) and :raise (the error event).
   OPERATIONS = {
+    "activateCanvas" => {
+      method: "POST",
+      path: "/v1/canvases/{canvas_id}/activate",
+      path_params: ["canvas_id"].freeze,
+      needs_token: true,
+      request_body: "ActivateCanvasRequest",
+      response: "Canvas",
+      stream: nil
+    }.freeze,
+    "activateDialogue" => {
+      method: "POST",
+      path: "/v1/dialogues/{dialogue_id}/activate",
+      path_params: ["dialogue_id"].freeze,
+      needs_token: true,
+      request_body: "ActivateDialogueRequest",
+      response: "Dialogue",
+      stream: nil
+    }.freeze,
+    "createCanvas" => {
+      method: "POST",
+      path: "/v1/canvases",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: "CreateCanvasRequest",
+      response: "Canvas",
+      stream: nil
+    }.freeze,
+    "createDialogue" => {
+      method: "POST",
+      path: "/v1/dialogues",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: "CreateDialogueRequest",
+      response: "Dialogue",
+      stream: nil
+    }.freeze,
     "createEmbedToken" => {
       method: "POST",
       path: "/v1/embed/tokens",
@@ -33,6 +69,24 @@ module Lingara
       response: nil,
       stream: nil
     }.freeze,
+    "dryRunCanvasPlan" => {
+      method: "POST",
+      path: "/v1/canvases/dry-run",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: "CanvasPlan",
+      response: "CanvasDryRun",
+      stream: nil
+    }.freeze,
+    "exportDialogue" => {
+      method: "GET",
+      path: "/v1/dialogues/{dialogue_id}/export",
+      path_params: ["dialogue_id"].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: "DialogueDefinition",
+      stream: nil
+    }.freeze,
     "generateVocabulary" => {
       method: "POST",
       path: "/v1/vocab/stream",
@@ -60,6 +114,24 @@ module Lingara
       response: nil,
       stream: nil
     }.freeze,
+    "getCanvas" => {
+      method: "GET",
+      path: "/v1/canvases/{canvas_id}",
+      path_params: ["canvas_id"].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: "Canvas",
+      stream: nil
+    }.freeze,
+    "getDialogue" => {
+      method: "GET",
+      path: "/v1/dialogues/{dialogue_id}",
+      path_params: ["dialogue_id"].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: "Dialogue",
+      stream: nil
+    }.freeze,
     "getLessonPlan" => {
       method: "GET",
       path: "/v1/lesson-plans/{id}",
@@ -105,6 +177,24 @@ module Lingara
       response: "VersionList",
       stream: nil
     }.freeze,
+    "listCanvases" => {
+      method: "GET",
+      path: "/v1/canvases",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: "CanvasPage",
+      stream: nil
+    }.freeze,
+    "listDialogues" => {
+      method: "GET",
+      path: "/v1/dialogues",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: "DialoguePage",
+      stream: nil
+    }.freeze,
     "listEvents" => {
       method: "GET",
       path: "/v1/events",
@@ -114,6 +204,42 @@ module Lingara
       response: "EventPage",
       stream: nil
     }.freeze,
+    "renameCanvas" => {
+      method: "PATCH",
+      path: "/v1/canvases/{canvas_id}",
+      path_params: ["canvas_id"].freeze,
+      needs_token: true,
+      request_body: "RenameCanvasRequest",
+      response: "Canvas",
+      stream: nil
+    }.freeze,
+    "renameDialogue" => {
+      method: "PATCH",
+      path: "/v1/dialogues/{dialogue_id}",
+      path_params: ["dialogue_id"].freeze,
+      needs_token: true,
+      request_body: "RenameDialogueRequest",
+      response: "Dialogue",
+      stream: nil
+    }.freeze,
+    "saveCanvasDraft" => {
+      method: "PUT",
+      path: "/v1/canvases/{canvas_id}/draft",
+      path_params: ["canvas_id"].freeze,
+      needs_token: true,
+      request_body: "SaveCanvasDraftRequest",
+      response: "Canvas",
+      stream: nil
+    }.freeze,
+    "saveDialogueDraft" => {
+      method: "PUT",
+      path: "/v1/dialogues/{dialogue_id}/draft",
+      path_params: ["dialogue_id"].freeze,
+      needs_token: true,
+      request_body: "SaveDialogueDraftRequest",
+      response: "Dialogue",
+      stream: nil
+    }.freeze,
     "sendDialogueTurn" => {
       method: "POST",
       path: "/v1/embed/dialogue/turns",
@@ -121,7 +247,7 @@ module Lingara
       needs_token: true,
       request_body: "DialogueTurnRequest",
       response: nil,
-      stream: {union: "SendDialogueTurnEvent", events: {"delta" => "SendDialogueTurnEventDelta", "notice" => "SendDialogueTurnEventNotice", "done" => "SendDialogueTurnEventDone", "error" => "SendDialogueTurnEventError"}.freeze, ends: {"done" => :quiet, "error" => :raise}.freeze}.freeze
+      stream: {union: "SendDialogueTurnEvent", events: {"delta" => "SendDialogueTurnEventDelta", "notice" => "SendDialogueTurnEventNotice", "transition" => "SendDialogueTurnEventTransition", "done" => "SendDialogueTurnEventDone", "error" => "SendDialogueTurnEventError"}.freeze, ends: {"done" => :quiet, "error" => :raise}.freeze}.freeze
     }.freeze,
     "sendEvent" => {
       method: "POST",

data/lib/lingara/streams.rb

@@ -58,6 +58,7 @@ module Lingara
     BRANCHES = {
       "delta" => SendDialogueTurnEventDelta,
       "notice" => SendDialogueTurnEventNotice,
+      "transition" => SendDialogueTurnEventTransition,
       "done" => SendDialogueTurnEventDone,
       "error" => SendDialogueTurnEventError
     }.freeze

data/lib/lingara/version.rb

@@ -2,12 +2,12 @@
 
 module Lingara
   # This library's released version, SemVer, sent in every User-Agent (K6).
-  VERSION = "0.2.0-alpha.4"
+  VERSION = "0.2.0-alpha.6"
 
   # The same version in RubyGems' spelling, which the gemspec uses.
-  GEM_VERSION = "0.2.0.pre.alpha.4"
+  GEM_VERSION = "0.2.0.pre.alpha.6"
 
   # The /v1 version this library's models were generated from. A response
   # served under another version logs one warning per version id.
-  GENERATED_FOR_VERSION = "2026-10-virile-dragon"
+  GENERATED_FOR_VERSION = "2026-10-simple-tarpon"
 end

data/lib/lingara.rb

@@ -23,3 +23,5 @@ require_relative "lingara/client_credentials"
 require_relative "lingara/event_stream"
 require_relative "lingara/events"
 require_relative "lingara/client"
+require_relative "lingara/canvas"
+require_relative "lingara/dialogue"

data/sig/lingara.rbs

@@ -75,6 +75,56 @@ module Lingara
     def link_embed_player: (String player_ref) -> Response
     def unlink_embed_player: (String player_ref) -> Response
     def send_dialogue_turn: (**untyped body) { (event) -> void } -> StreamResult
+    # ADR 16.10.26ak: the canvas operations, as a group.
+    def canvases: () -> Canvases
+    # ADR 29.10.26c: the stored-dialogue operations, as a group.
+    def dialogues: () -> Dialogues
+  end
+
+  class Dialogues
+    def initialize: (^(String, Array[String], Hash[Symbol, untyped]?, untyped) -> Response request,
+                     ^(Array[String], Hash[Symbol, String?], Hash[String, String]) -> Response export) -> void
+    def list_dialogues: (?cursor: String?, ?limit: Integer?, ?name: String?) -> Response
+    def create_dialogue: (Hash[untyped, untyped] body) -> Response
+    def get_dialogue: (String dialogue_id) -> Response
+    def rename_dialogue: (String dialogue_id, Hash[untyped, untyped] body) -> Response
+    def save_dialogue_draft: (String dialogue_id, Hash[untyped, untyped] body) -> Response
+    def activate_dialogue: (String dialogue_id, Hash[untyped, untyped] body) -> Response
+    # The Response's value is an ExportedDialogue::Body or ::NotModified.
+    def export_dialogue: (String dialogue_id, ?revision: String?, ?layout: String?, ?if_none_match: String?) -> Response
+    def page_dialogues: (**untyped filters) { (untyped) -> void } -> untyped
+                      | (**untyped filters) -> Enumerator[untyped, untyped]
+  end
+
+  # ADR 29.10.26c D6: the export's two arms.
+  module ExportedDialogue
+    def self.from: (untyped response) -> (Body | NotModified)
+
+    class Body < ::Data
+      attr_reader revision: Integer
+      attr_reader etag: String
+      attr_reader ir_json: String
+      def initialize: (revision: Integer, etag: String, ir_json: String) -> void
+    end
+
+    class NotModified < ::Data
+      attr_reader revision: Integer
+      attr_reader etag: String
+      def initialize: (revision: Integer, etag: String) -> void
+    end
+  end
+
+  class Canvases
+    def initialize: (^(String, Array[String], Hash[Symbol, untyped]?, untyped) -> Response request) -> void
+    def list_canvases: (?cursor: String?, ?limit: Integer?, ?name: String?, ?status: String?, ?recipes: Array[String]?, ?kinds: Array[String]?, ?scopes: Array[String]?) -> Response
+    def create_canvas: (Hash[untyped, untyped] body) -> Response
+    def get_canvas: (String canvas_id) -> Response
+    def rename_canvas: (String canvas_id, Hash[untyped, untyped] body) -> Response
+    def save_canvas_draft: (String canvas_id, Hash[untyped, untyped] body) -> Response
+    def activate_canvas: (String canvas_id, Hash[untyped, untyped] body) -> Response
+    def dry_run_canvas_plan: (Hash[untyped, untyped] body) -> Response
+    def page_canvases: (**untyped filters) { (untyped) -> void } -> untyped
+                     | (**untyped filters) -> Enumerator[untyped, untyped]
   end
 
   class MintedToken

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lingara
 version: !ruby/object:Gem::Version
-  version: 0.2.0.pre.alpha.4
+  version: 0.2.0.pre.alpha.6
 platform: ruby
 authors:
 - Spinning Cat Studios
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-23 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies: []
 description: Generate vocabulary lists and lesson plans, and hold tutor conversations,
   through the Lingara API. Streams are blocks or Enumerables; the standard library
@@ -22,9 +22,11 @@ files:
 - README.md
 - lib/lingara.rb
 - lib/lingara/access_token.rb
+- lib/lingara/canvas.rb
 - lib/lingara/client.rb
 - lib/lingara/client_credentials.rb
 - lib/lingara/deprecation.rb
+- lib/lingara/dialogue.rb
 - lib/lingara/errors.rb
 - lib/lingara/event_stream.rb
 - lib/lingara/events.rb
@@ -33,28 +35,63 @@ files:
 - lib/lingara/events/tail.rb
 - lib/lingara/events/webhook.rb
 - lib/lingara/minted_token.rb
+- lib/lingara/models/activate_canvas_request.rb
+- lib/lingara/models/activate_dialogue_request.rb
 - lib/lingara/models/allowance_row.rb
 - lib/lingara/models/app_context_slice.rb
 - lib/lingara/models/app_disabled_data.rb
 - lib/lingara/models/app_enabled_data.rb
 - lib/lingara/models/app_installed_data.rb
 - lib/lingara/models/app_uninstalled_data.rb
+- lib/lingara/models/canvas.rb
+- lib/lingara/models/canvas_activation_outcome.rb
+- lib/lingara/models/canvas_active.rb
+- lib/lingara/models/canvas_definition.rb
+- lib/lingara/models/canvas_draft.rb
+- lib/lingara/models/canvas_dry_run.rb
+- lib/lingara/models/canvas_edge.rb
+- lib/lingara/models/canvas_made_object.rb
+- lib/lingara/models/canvas_node.rb
+- lib/lingara/models/canvas_node_kind.rb
+- lib/lingara/models/canvas_object_ref.rb
+- lib/lingara/models/canvas_page.rb
+- lib/lingara/models/canvas_param.rb
+- lib/lingara/models/canvas_plan.rb
+- lib/lingara/models/canvas_recipe.rb
+- lib/lingara/models/canvas_summary.rb
+- lib/lingara/models/canvas_verdict.rb
+- lib/lingara/models/canvas_verdict_kind.rb
+- lib/lingara/models/create_canvas_request.rb
+- lib/lingara/models/create_dialogue_request.rb
 - lib/lingara/models/create_lesson_plan_event_error.rb
 - lib/lingara/models/create_lesson_plan_event_phase.rb
 - lib/lingara/models/create_lesson_plan_event_result.rb
 - lib/lingara/models/create_lesson_plan_event_started.rb
+- lib/lingara/models/dialogue.rb
+- lib/lingara/models/dialogue_active.rb
+- lib/lingara/models/dialogue_draft.rb
 - lib/lingara/models/dialogue_entry.rb
+- lib/lingara/models/dialogue_npc.rb
+- lib/lingara/models/dialogue_page.rb
+- lib/lingara/models/dialogue_rule.rb
+- lib/lingara/models/dialogue_summary.rb
+- lib/lingara/models/dialogue_transition.rb
 - lib/lingara/models/dialogue_turn_request.rb
+- lib/lingara/models/dialogue_warning.rb
+- lib/lingara/models/dialogue_warning_code.rb
 - lib/lingara/models/embed_player_link.rb
 - lib/lingara/models/embed_token.rb
 - lib/lingara/models/embed_token_request.rb
 - lib/lingara/models/error_envelope.rb
 - lib/lingara/models/event_envelope.rb
 - lib/lingara/models/event_page.rb
+- lib/lingara/models/fact_value.rb
 - lib/lingara/models/generate_vocabulary_event_done.rb
 - lib/lingara/models/generate_vocabulary_event_error.rb
 - lib/lingara/models/generate_vocabulary_event_item.rb
 - lib/lingara/models/generate_vocabulary_event_started.rb
+- lib/lingara/models/graph_checkpoint.rb
+- lib/lingara/models/graph_edge.rb
 - lib/lingara/models/inbound_event_accepted.rb
 - lib/lingara/models/lesson_plan.rb
 - lib/lingara/models/lesson_plan_content.rb
@@ -64,6 +101,8 @@ files:
 - lib/lingara/models/link_status.rb
 - lib/lingara/models/notice.rb
 - lib/lingara/models/npc.rb
+- lib/lingara/models/npc_language.rb
+- lib/lingara/models/pedagogy.rb
 - lib/lingara/models/plan_fail_reason.rb
 - lib/lingara/models/plan_pending.rb
 - lib/lingara/models/plan_phase.rb
@@ -79,10 +118,15 @@ files:
 - lib/lingara/models/practice_outcome.rb
 - lib/lingara/models/reaction_report.rb
 - lib/lingara/models/reaction_status.rb
+- lib/lingara/models/rename_canvas_request.rb
+- lib/lingara/models/rename_dialogue_request.rb
+- lib/lingara/models/save_canvas_draft_request.rb
+- lib/lingara/models/save_dialogue_draft_request.rb
 - lib/lingara/models/send_dialogue_turn_event_delta.rb
 - lib/lingara/models/send_dialogue_turn_event_done.rb
 - lib/lingara/models/send_dialogue_turn_event_error.rb
 - lib/lingara/models/send_dialogue_turn_event_notice.rb
+- lib/lingara/models/send_dialogue_turn_event_transition.rb
 - lib/lingara/models/send_tutor_message_event_delta.rb
 - lib/lingara/models/send_tutor_message_event_done.rb
 - lib/lingara/models/send_tutor_message_event_error.rb