SkillKit.Conversation.Store behaviour (SkillKit v0.1.0)

Copy Markdown View Source

Behaviour for conversation persistence backends.

Implementations store and retrieve conversation message history, enabling agents to resume conversations after restarts.

Summary

Types

conversation_id()
message()

Callbacks

delete(conversation_id, keyword)
load(conversation_id, keyword)
save(conversation_id, list, keyword)

Types

conversation_id()

@type conversation_id() :: String.t()

message()

@type message() ::
  SkillKit.Types.UserMessage.t()
  | SkillKit.Types.AssistantMessage.t()
  | SkillKit.Types.SystemMessage.t()
  | SkillKit.Types.ToolResult.t()

Callbacks

delete(conversation_id, keyword)

@callback delete(
  conversation_id(),
  keyword()
) :: :ok | {:error, term()}

load(conversation_id, keyword)

@callback load(
  conversation_id(),
  keyword()
) :: {:ok, [message()]} | {:error, term()}

save(conversation_id, list, keyword)

@callback save(conversation_id(), [message()], keyword()) :: :ok | {:error, term()}