@xiaozhiclaw/qlogicagent-core

Host-neutral qlogicagent turn and tool-loop runtime for server embedding.

import {
  createEmbeddedAgent,
  type LLMTransport,
  type ToolInvoker,
} from "@xiaozhiclaw/qlogicagent-core";

const agent = createEmbeddedAgent({
  llmTransport: transport satisfies LLMTransport,
  toolInvoker: tools satisfies ToolInvoker,
  apiKey: process.env.MODEL_API_KEY,
  maxRounds: 6,
});

for await (const event of agent.run({
  turnId: crypto.randomUUID(),
  sessionId: conversationId,
  messages,
  tools,
  config: { model: "model-id", maxToolCalls: 3 },
})) {
  // Persist or forward the typed turn events required by the host product.
}

The embedding boundary owns only model/tool turn behavior. The caller retains authentication, tenant and conversation authority, persistence, knowledge, business workflows, and deployment. The package does not require the desktop Host, ACP, MCP, SQLite, Redis, Skills, sub-agents, filesystem tools, or shell tools.