PtcRunner.Lisp.Context (PtcRunner v0.14.0)

Copy Markdown View Source

Manages context, memory, and tools for program execution.

  • ctx: External input data (read-only)
  • memory: Mutable state passed through evaluation
  • tools: Tool registry

Kernel environments construct this context at the evaluator boundary.

Summary

Types

t()

Context structure containing external data, memory, and tool registry.

Functions

get_ctx(context, name)

Retrieves a value from context (external data).

get_memory(context, name)

Retrieves a value from memory (mutable state).

new(ctx \\ %{}, memory \\ %{}, tools \\ %{}, turn_history \\ [])

Creates a new context with external data, memory, tools, and optional turn history.

put_memory(context, name, value)

Sets a value in memory.

Types

t()

@type t() :: %PtcRunner.Lisp.Context{
  ctx: map(),
  memory: map(),
  tools: map(),
  turn_history: list()
}

Context structure containing external data, memory, and tool registry.

Functions

get_ctx(context, name)

@spec get_ctx(t(), String.t()) :: {:ok, any()} | {:error, {atom(), String.t()}}

Retrieves a value from context (external data).

Returns {:ok, nil} if key doesn't exist.

Examples

iex> ctx = PtcRunner.Lisp.Context.new(%{"users" => [1, 2, 3]})
iex> PtcRunner.Lisp.Context.get_ctx(ctx, "users")
{:ok, [1, 2, 3]}

iex> ctx = PtcRunner.Lisp.Context.new()
iex> PtcRunner.Lisp.Context.get_ctx(ctx, "missing")
{:ok, nil}

get_memory(context, name)

@spec get_memory(t(), String.t()) :: {:ok, any()} | {:error, {atom(), String.t()}}

Retrieves a value from memory (mutable state).

Returns {:ok, nil} if key doesn't exist.

Examples

iex> ctx = PtcRunner.Lisp.Context.new(%{}, %{"counter" => 42})
iex> PtcRunner.Lisp.Context.get_memory(ctx, "counter")
{:ok, 42}

iex> ctx = PtcRunner.Lisp.Context.new()
iex> PtcRunner.Lisp.Context.get_memory(ctx, "missing")
{:ok, nil}

new(ctx \\ %{}, memory \\ %{}, tools \\ %{}, turn_history \\ [])

@spec new(map(), map(), map(), list()) :: t()

Creates a new context with external data, memory, tools, and optional turn history.

Examples

iex> ctx = PtcRunner.Lisp.Context.new(%{"users" => [1, 2, 3]})
iex> ctx.ctx
%{"users" => [1, 2, 3]}

iex> ctx = PtcRunner.Lisp.Context.new(%{}, %{"counter" => 0})
iex> ctx.memory
%{"counter" => 0}

put_memory(context, name, value)

@spec put_memory(t(), String.t(), any()) :: t()

Sets a value in memory.

Examples

iex> ctx = PtcRunner.Lisp.Context.new()
iex> ctx = PtcRunner.Lisp.Context.put_memory(ctx, "result", 100)
iex> ctx.memory
%{"result" => 100}