acty-langchain

acty-langchain

acty-langchain provides LangChain-specific helpers for the Acty ecosystem: message serialization, repair hints for malformed JSON outputs, and runnable executor utilities that integrate with acty.

Install

Runtime helpers only:

pip install acty-langchain

If you want to run LangChain runnables through ActyEngine:

pip install acty acty-langchain

For local development:

pip install -e .[dev]

Message Payload Helpers

from langchain_core.messages import HumanMessage
from acty_langchain import messages_to_acty_payload, messages_from_acty_payload

payload = messages_to_acty_payload(
    [HumanMessage(content="hello")],
    payload={"exec_id": "chat"},
)

roundtrip = messages_from_acty_payload(payload)

These helpers convert LangChain messages into JSON-safe payload structures that can be stored, retried, or cached inside Acty workflows.

Runnable Payload Shape

The runnable executor accepts payloads shaped like:

{
    "runnable": my_chain,
    "input": {"question": "hi"},
}

Resolver-based execution can also use:

{
    "exec_id": "qa",
    "input": {"question": "hi"},
}

Runnable Execution

from acty import ActyEngine, EngineConfig
from acty_langchain import LangChainRunnableExecutor, runnable_retry_factory

engine = ActyEngine(
    executor=LangChainRunnableExecutor(),
    config=EngineConfig(
        attempt_retry_policy=runnable_retry_factory(),
    ),
)

JSON Repair Helpers

acty-langchain also includes repair utilities for invalid JSON responses:

from acty_langchain import DefaultPromptedJsonRepairer

repairer = DefaultPromptedJsonRepairer(
    system_instruction="Return only valid JSON.",
    repair_request="Please repair the assistant output above.",
)

Development

• tests live under tests/
• the package depends on acty-core at runtime
• tests also install acty so runnable executor integration can be exercised