ASM.Migration.MainCompat (ASM v0.9.2)

Compatibility helpers for migrating main SessionManager input/event shapes to the rebuild ASM runtime.

This module is intentionally explicit about unsupported migration paths:

Amp and Shell adapter migration is blocked in this helper.
main workflow options that require extension/domain parity are rejected with actionable %ASM.Error{} messages.

Summary

Types

legacy_event()

main_input()

provider_hint()

query_spec()

Functions

bridge_event(event)

bridge_stream(stream)

build_query(provider_hint, input, opts \\ [])

input_to_prompt(prompt)

resolve_provider(provider_hint)

run_once(provider_hint, input, opts \\ [])

run_once(store, provider_hint, input, opts)

Types

legacy_event()

@type legacy_event() :: %{
  type: atom(),
  timestamp: DateTime.t(),
  session_id: String.t(),
  run_id: String.t(),
  data: map(),
  provider: atom()
}

main_input()

@type main_input() :: String.t() | map()

provider_hint()

@type provider_hint() :: atom() | String.t()

query_spec()

@type query_spec() :: %{
  provider: :claude | :codex | :gemini,
  prompt: String.t(),
  session_opts: keyword(),
  query_opts: keyword()
}

Functions

bridge_event(event)

@spec bridge_event(ASM.Event.t()) :: [legacy_event()]

bridge_stream(stream)

@spec bridge_stream(Enumerable.t()) :: Enumerable.t()

build_query(provider_hint, input, opts \\ [])

@spec build_query(provider_hint(), main_input(), keyword()) ::
  {:ok, query_spec()} | {:error, ASM.Error.t()}

input_to_prompt(prompt)

@spec input_to_prompt(main_input()) :: {:ok, String.t()} | {:error, ASM.Error.t()}

resolve_provider(provider_hint)

@spec resolve_provider(provider_hint()) ::
  {:ok, :claude | :codex | :gemini} | {:error, ASM.Error.t()}

run_once(provider_hint, input, opts \\ [])

@spec run_once(provider_hint(), main_input(), keyword()) ::
  {:ok, map()} | {:error, ASM.Error.t()}

run_once(store, provider_hint, input, opts)

@spec run_once(term(), provider_hint(), main_input(), keyword()) ::
  {:ok, map()} | {:error, ASM.Error.t()}