Resolve a session ID from a thread ID, falling back to DB then generating a new one.

* Reads `CLAUDE.md` from `cwd`, resolves any `@path/file` imports, and * writes the result as `AGENTS.md` so the Codex CLI can pick it up as its

Trim old step elements until the card fits Feishu's card limit.

* Sets the `first_message` for a session if it is still empty (write-once semantics). * @param sessionId - The session identifier. * @param firs

* Updates the `last_message_created_at` and `updated_at` timestamps for a session. * @param sessionId - The session identifier.

* Bootstraps the application by verifying the integrity and then igniting the kernel.

* Creates the Hono app with all API routes mounted. * * Extracted as a standalone function so TypeScript can infer the full * chained route type, w

* Creates a session for a handoff from an external Claude Code instance. * The session already exists in Claude's native store, so it is created

* Creates a new session and inserts a row into the database. * @param sessionId - The session identifier. * @param options - Optional agent_type

* Reads Claude Code credentials from macOS Keychain via `security find-generic-password`. * Returns the stored value (a JSON string) parsed as an obj

* Get the currently running task for a session, if any. * @param sessionId - The session ID to look up. * @returns The task ID if found, undefin

* Get a pending or running task by its inbound message ID. * @param messageId - The Feishu message ID to look up. * @returns The task ID if foun

* Parses a YAML frontmatter block from a markdown file's content. * * Uses Bun's built-in YAML parser to support full YAML 1.2 syntax including * m

* Returns sessions ordered by `updated_at` descending. * @param limit - Maximum number of sessions to return (default 50). * @returns An array o

* Query tasks across every state, sorted by creation time descending. * Unlike bunqueue's in-memory query, this reads from the persisted * `task

* Reads all skills from `config.paths.skills` (`$AGENTARA_HOME/.claude/skills/`). * * Each skill lives in its own subdirectory and exposes metadata

* Resumes an existing session by reading its metadata from the database. * @param sessionId - The session identifier. * @param options - Optiona

* Register or update a scheduled task. * Persists the definition to the `scheduled_tasks` table and registers * a bunqueue job scheduler. Each t

* Return a stream of messages from the agent. * @param userMessage - The message to send to the agent. * @param streamOptions - Optional options

* Update an existing scheduled task by its scheduler ID. * Updates the DB row and re-registers the bunqueue scheduler. * @param schedulerId - Th

* Uploads a file to Feishu. Returns the key of the uploaded file. * @param filePath - The path to the file relative to the home directory. * @re