union-ark-web 1.0.1

package/ark-control/src/main/resources/mapper/ScheduledTaskMapper.xml

@@ -0,0 +1,286 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.union.control.mapper.ScheduledTaskMapper">
+
+    <sql id="taskFields">
+        t.id,t.title,t.prompt,t.schedule_type AS scheduleType,
+        DATE_FORMAT(t.run_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS runAt,
+        t.cron_expression AS cronExpression,t.interval_seconds AS intervalSeconds,
+        t.timezone,t.status,
+        DATE_FORMAT(t.next_run_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS nextRunAt,
+        DATE_FORMAT(t.created_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS createdAt,
+        DATE_FORMAT(t.updated_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS updatedAt
+    </sql>
+
+    <sql id="runSummaryFields">
+        r.id,r.task_id AS taskId,
+        DATE_FORMAT(r.scheduled_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS scheduledAt,
+        r.status,r.result_conversation_id AS resultConversationId,r.read_flag AS readFlag,
+        r.error_code AS errorCode,r.error_message AS errorMessage,
+        DATE_FORMAT(r.started_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS startedAt,
+        DATE_FORMAT(r.finished_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS finishedAt,
+        DATE_FORMAT(r.created_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS createdAt
+    </sql>
+
+    <sql id="taskFilter">
+        WHERE t.user_id=#{userId} AND t.delete_flag=1
+        <if test="keyword != null">
+            AND (t.title LIKE #{keyword} ESCAPE '!' OR t.prompt LIKE #{keyword} ESCAPE '!')
+        </if>
+        <if test="status != null">AND t.status=#{status}</if>
+    </sql>
+
+    <select id="lockUserTasks" resultType="long">
+        SELECT id FROM agent_scheduled_task
+        WHERE user_id=#{userId} AND delete_flag=1 FOR UPDATE
+    </select>
+
+    <select id="countRunnableTasks" resultType="int">
+        SELECT COUNT(*) FROM agent_scheduled_task
+        WHERE user_id=#{userId} AND delete_flag=1 AND status IN ('ACTIVE','PAUSED')
+    </select>
+
+    <insert id="insertTask" parameterType="map" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO agent_scheduled_task
+            (user_id,org_code,role_id,title,prompt,schedule_type,run_at,cron_expression,interval_seconds,
+             timezone,status,next_run_at,delete_flag,created_at,updated_at)
+        VALUES
+            (#{userId},#{orgCode},#{roleId},#{title},#{prompt},#{scheduleType},#{runAt},#{cronExpression},
+             #{intervalSeconds},#{timezone},'ACTIVE',#{nextRunAt},1,
+             UTC_TIMESTAMP(3),UTC_TIMESTAMP(3))
+    </insert>
+
+    <update id="updateTask" parameterType="map">
+        UPDATE agent_scheduled_task
+        SET org_code=#{orgCode},role_id=#{roleId},title=#{title},prompt=#{prompt},schedule_type=#{scheduleType},run_at=#{runAt},
+            cron_expression=#{cronExpression},interval_seconds=#{intervalSeconds},timezone=#{timezone},
+            next_run_at=CASE WHEN status='ACTIVE' THEN #{nextRunAt} ELSE NULL END,
+            updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{taskId} AND user_id=#{userId} AND delete_flag=1
+    </update>
+
+    <select id="countTasks" resultType="long">
+        SELECT COUNT(*) FROM agent_scheduled_task t
+        <include refid="taskFilter"/>
+    </select>
+
+    <select id="findTasks" resultType="map">
+        SELECT <include refid="taskFields"/>,
+               (SELECT r.status FROM agent_scheduled_task_run r
+                WHERE r.task_id=t.id AND r.delete_flag=1
+                ORDER BY r.scheduled_at DESC,r.id DESC LIMIT 1) AS latestRunStatus
+        FROM agent_scheduled_task t
+        <include refid="taskFilter"/>
+        ORDER BY t.updated_at DESC,t.id DESC LIMIT #{limit} OFFSET #{offset}
+    </select>
+
+    <select id="findTaskDetail" resultType="map">
+        SELECT <include refid="taskFields"/>,
+               (SELECT r.status FROM agent_scheduled_task_run r
+                WHERE r.task_id=t.id AND r.delete_flag=1
+                ORDER BY r.scheduled_at DESC,r.id DESC LIMIT 1) AS latestRunStatus
+        FROM agent_scheduled_task t
+        WHERE t.id=#{taskId} AND t.user_id=#{userId} AND t.delete_flag=1
+    </select>
+
+    <select id="findTaskOwner" resultType="map">
+        SELECT id,schedule_type AS scheduleType,run_at AS runAt,
+               cron_expression AS cronExpression,interval_seconds AS intervalSeconds,
+               timezone,status
+        FROM agent_scheduled_task
+        WHERE id=#{taskId} AND user_id=#{userId} AND delete_flag=1
+        <if test="lock">FOR UPDATE</if>
+    </select>
+
+    <select id="countRuns" resultType="long">
+        SELECT COUNT(*)
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE r.task_id=#{taskId} AND r.delete_flag=1
+          AND t.user_id=#{userId} AND t.delete_flag=1
+    </select>
+
+    <select id="findRuns" resultType="map">
+        SELECT <include refid="runSummaryFields"/>
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE r.task_id=#{taskId} AND r.delete_flag=1
+          AND t.user_id=#{userId} AND t.delete_flag=1
+        ORDER BY r.scheduled_at DESC,r.id DESC LIMIT #{limit} OFFSET #{offset}
+    </select>
+
+    <select id="findOwnedRun" resultType="map">
+        SELECT <include refid="runSummaryFields"/>,r.result_payload AS resultPayload,
+               t.title,t.prompt,t.user_id AS userId
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE r.id=#{runId} AND r.delete_flag=1
+          AND t.user_id=#{userId} AND t.delete_flag=1
+        <if test="lock">FOR UPDATE</if>
+    </select>
+
+    <select id="countUnread" resultType="long">
+        SELECT COUNT(*)
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE t.user_id=#{userId} AND t.delete_flag=1 AND r.delete_flag=1
+          AND r.status IN ('SUCCEEDED','FAILED') AND r.read_flag=0
+    </select>
+
+    <select id="findUnread" resultType="map">
+        SELECT <include refid="runSummaryFields"/>,t.title
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE t.user_id=#{userId} AND t.delete_flag=1 AND r.delete_flag=1
+          AND r.status IN ('SUCCEEDED','FAILED') AND r.read_flag=0
+        ORDER BY r.finished_at DESC,r.id DESC LIMIT 100
+    </select>
+
+    <update id="activateTask">
+        UPDATE agent_scheduled_task
+        SET status='ACTIVE',next_run_at=#{nextRunAt},updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{taskId} AND user_id=#{userId} AND delete_flag=1 AND status='PAUSED'
+    </update>
+
+    <update id="pauseTask">
+        UPDATE agent_scheduled_task
+        SET status='PAUSED',next_run_at=NULL,updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{taskId} AND user_id=#{userId} AND delete_flag=1 AND status='ACTIVE'
+    </update>
+
+    <update id="discardTask">
+        UPDATE agent_scheduled_task t
+        LEFT JOIN agent_scheduled_task_run r
+          ON r.task_id=t.id AND r.delete_flag=1 AND r.status IN ('PENDING','RUNNING')
+        SET t.delete_flag=0,t.next_run_at=NULL,t.updated_at=UTC_TIMESTAMP(3),
+            r.status='FAILED',r.error_code='scheduled_task_discarded',
+            r.error_message='定时任务已删除',r.finished_at=UTC_TIMESTAMP(3),
+            r.updated_at=UTC_TIMESTAMP(3),r.execution_token_hash=NULL,
+            r.execution_token_expires_at=NULL
+        WHERE t.id=#{taskId} AND t.user_id=#{userId} AND t.delete_flag=1
+    </update>
+
+    <select id="findDueTask" resultType="map">
+        SELECT id,schedule_type AS scheduleType,run_at AS runAt,
+               cron_expression AS cronExpression,interval_seconds AS intervalSeconds,
+               timezone,next_run_at AS nextRunAt
+        FROM agent_scheduled_task
+        WHERE delete_flag=1 AND status='ACTIVE' AND next_run_at&lt;=UTC_TIMESTAMP(3)
+        ORDER BY next_run_at,id LIMIT 1 FOR UPDATE SKIP LOCKED
+    </select>
+
+    <insert id="insertRun" parameterType="map" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO agent_scheduled_task_run
+            (task_id,scheduled_at,status,read_flag,delete_flag,created_at,updated_at)
+        VALUES (#{taskId},#{scheduledAt},'PENDING',0,1,UTC_TIMESTAMP(3),UTC_TIMESTAMP(3))
+    </insert>
+
+    <update id="completeOnceTask">
+        UPDATE agent_scheduled_task
+        SET status='COMPLETED',next_run_at=NULL,updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{taskId} AND schedule_type='ONCE' AND delete_flag=1
+    </update>
+
+    <update id="updateNextRun">
+        UPDATE agent_scheduled_task
+        SET next_run_at=#{nextRunAt},updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{taskId}
+    </update>
+
+    <select id="findPendingRunIds" resultType="long">
+        SELECT id FROM agent_scheduled_task_run
+        WHERE delete_flag=1 AND status='PENDING'
+        ORDER BY created_at,id LIMIT #{limit}
+    </select>
+
+    <update id="beginRun">
+        UPDATE agent_scheduled_task_run
+        SET status='RUNNING',started_at=UTC_TIMESTAMP(3),updated_at=UTC_TIMESTAMP(3),
+            execution_token_hash=#{tokenHash},
+            execution_token_expires_at=#{tokenExpiresAt}
+        WHERE id=#{runId} AND delete_flag=1 AND status='PENDING'
+          AND EXISTS (SELECT 1 FROM agent_scheduled_task t
+                      WHERE t.id=agent_scheduled_task_run.task_id AND t.delete_flag=1)
+    </update>
+
+    <select id="findPendingRunContext" resultType="map">
+        SELECT r.id AS runId,r.task_id AS taskId,t.user_id AS userId,t.org_code AS orgCode,
+               t.role_id AS roleId
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE r.id=#{runId} AND r.delete_flag=1 AND r.status='PENDING' AND t.delete_flag=1
+    </select>
+
+    <select id="resolveScheduledToken" resultType="map">
+        SELECT r.id AS runId,r.task_id AS taskId,t.user_id AS userId,t.org_code AS orgCode,
+               t.role_id AS roleId,t.prompt,t.timezone,
+               DATE_FORMAT(r.scheduled_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS scheduledAt,
+               DATE_FORMAT(r.execution_token_expires_at,'%Y-%m-%dT%H:%i:%s.%fZ') AS expiresAt,
+               r.execution_token_hash AS tokenHash
+        FROM agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        WHERE r.execution_token_hash=#{tokenHash}
+          AND r.delete_flag=1 AND r.status='RUNNING'
+          AND r.execution_token_expires_at&gt;UTC_TIMESTAMP(3)
+          AND t.delete_flag=1 AND t.user_id IS NOT NULL AND t.user_id&lt;&gt;''
+          AND t.org_code IS NOT NULL AND t.org_code&lt;&gt;''
+          AND t.role_id IS NOT NULL AND t.role_id&lt;&gt;''
+    </select>
+
+    <select id="findRunForUpdate" resultType="map">
+        SELECT id,task_id AS taskId,status
+        FROM agent_scheduled_task_run
+        WHERE id=#{runId} AND delete_flag=1 FOR UPDATE
+    </select>
+
+    <update id="completeRun">
+        UPDATE agent_scheduled_task_run
+        SET status='SUCCEEDED',result_payload=#{resultPayload},
+            finished_at=UTC_TIMESTAMP(3),updated_at=UTC_TIMESTAMP(3),
+            execution_token_hash=NULL,execution_token_expires_at=NULL
+        WHERE id=#{runId} AND delete_flag=1 AND status='RUNNING'
+    </update>
+
+    <update id="failRun">
+        UPDATE agent_scheduled_task_run
+        SET status='FAILED',error_code=#{errorCode},error_message=#{errorMessage},
+            finished_at=UTC_TIMESTAMP(3),updated_at=UTC_TIMESTAMP(3),
+            execution_token_hash=NULL,execution_token_expires_at=NULL
+        WHERE id=#{runId} AND delete_flag=1 AND status IN ('PENDING','RUNNING')
+    </update>
+
+    <update id="failStaleRuns">
+        UPDATE agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        SET r.status='FAILED',r.error_code='scheduled_run_timeout',
+            r.error_message='定时任务执行超时',r.finished_at=UTC_TIMESTAMP(3),
+            r.updated_at=UTC_TIMESTAMP(3),r.execution_token_hash=NULL,
+            r.execution_token_expires_at=NULL,
+            t.status=CASE WHEN t.schedule_type='ONCE' THEN 'COMPLETED' ELSE t.status END,
+            t.updated_at=UTC_TIMESTAMP(3)
+        WHERE r.delete_flag=1 AND r.status='RUNNING'
+          AND r.started_at&lt;DATE_SUB(UTC_TIMESTAMP(3),INTERVAL #{maxRunSeconds} SECOND)
+    </update>
+
+    <update id="markRunRead">
+        UPDATE agent_scheduled_task_run
+        SET read_flag=1,updated_at=UTC_TIMESTAMP(3) WHERE id=#{runId}
+    </update>
+
+    <update id="attachConversation">
+        UPDATE agent_scheduled_task_run
+        SET result_conversation_id=#{conversationId},read_flag=1,updated_at=UTC_TIMESTAMP(3)
+        WHERE id=#{runId} AND result_conversation_id IS NULL
+    </update>
+
+    <update id="softDeleteByConversation">
+        UPDATE agent_scheduled_task_run r
+        JOIN agent_scheduled_task t ON t.id=r.task_id
+        SET r.delete_flag=0,r.updated_at=UTC_TIMESTAMP(3)
+        WHERE r.result_conversation_id=#{conversationId} AND r.delete_flag=1
+          AND t.user_id=#{userId} AND t.delete_flag=1
+    </update>
+
+</mapper>

package/ark-control/src/main/resources/mapper/SensitiveDataDemoMapper.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.union.control.mapper.SensitiveDataDemoMapper">
+    <insert id="insert">
+        INSERT INTO sensitive_data_demo.sensitive_data_demo (phone_number)
+        VALUES (#{phoneNumber})
+    </insert>
+
+    <select id="query" resultType="map">
+        SELECT id, phone_number AS phoneNumber,
+               DATE_FORMAT(created_at, '%Y-%m-%dT%H:%i:%s') AS createdAt
+        FROM sensitive_data_demo.sensitive_data_demo
+        ORDER BY id DESC
+    </select>
+
+    <insert id="insertAddressBook" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO t_m_announce_address_book
+            (name, role, email, telephone, mobile_number)
+        VALUES
+            (#{name}, #{role}, #{email}, #{telephone}, #{mobileNumber})
+    </insert>
+
+    <select id="queryAddressBook"
+            resultType="com.union.control.mapper.SensitiveAddressBookDemo">
+        SELECT id, name, role, email, telephone,
+               mobile_number AS mobileNumber,
+               DATE_FORMAT(created_at, '%Y-%m-%dT%H:%i:%s') AS createdAt
+        FROM t_m_announce_address_book
+        ORDER BY id DESC
+    </select>
+    <insert id="insertSaved" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO sensitive_data_demo.sensitive_data_demo (phone_number) VALUES (#{phoneNumber})
+    </insert>
+    <update id="update">
+        UPDATE sensitive_data_demo.sensitive_data_demo SET phone_number = #{phoneNumber} WHERE id = #{id}
+    </update>
+    <select id="queryById" resultType="map">
+        SELECT id, phone_number AS phoneNumber,
+               DATE_FORMAT(created_at, '%Y-%m-%dT%H:%i:%s') AS createdAt
+        FROM sensitive_data_demo.sensitive_data_demo WHERE id = #{id}
+    </select>
+    <update id="updateAddressBook">
+        UPDATE t_m_announce_address_book
+        SET name = #{name}, role = #{role}, email = #{email},
+            telephone = #{telephone}, mobile_number = #{mobileNumber}
+        WHERE id = #{id}
+    </update>
+    <select id="queryAddressBookById" resultType="com.union.control.mapper.SensitiveAddressBookDemo">
+        SELECT id, name, role, email, telephone, mobile_number AS mobileNumber,
+               DATE_FORMAT(created_at, '%Y-%m-%dT%H:%i:%s') AS createdAt
+        FROM t_m_announce_address_book WHERE id = #{id}
+    </select>
+</mapper>

package/ark-control/src/main/resources/schema.sql

@@ -0,0 +1,146 @@
+CREATE TABLE IF NOT EXISTS `ai_conversation` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `conversation_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '业务会话标识，对应 AG-UI threadId',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '会话所属用户标识',
+  `title` VARCHAR(255) DEFAULT NULL COMMENT '会话标题',
+  `status` VARCHAR(32) NOT NULL DEFAULT 'active' COMMENT '会话状态：active-活跃，archived-已归档',
+  `is_pinned` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否置顶：1-是，0-否',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_conversation_id` (`conversation_id`),
+  KEY `idx_conversation_user_list` (`user_id`, `delete_flag`, `status`, `updated_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `ai_agent_execution` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `run_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT 'Agent 执行业务标识',
+  `conversation_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '所属业务会话标识',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '执行所属用户标识',
+  `parent_execution_id` BIGINT DEFAULT NULL COMMENT '父执行数据库主键，根执行为空',
+  `agent_name` VARCHAR(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT 'py-app 最终提交的 Agent 名称',
+  `delegation_tool_call_id` VARCHAR(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '父执行发起委派的工具调用标识',
+  `task` VARCHAR(1000) DEFAULT NULL COMMENT '委派给 Agent 的任务说明',
+  `status` VARCHAR(32) NOT NULL COMMENT 'py-app 提交的执行状态',
+  `finished_at` DATETIME DEFAULT NULL COMMENT '执行结束时间',
+  `error_code` VARCHAR(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '执行失败错误码',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_agent_execution_run` (`run_id`),
+  UNIQUE KEY `uk_parent_delegation_call` (`parent_execution_id`, `delegation_tool_call_id`),
+  KEY `idx_execution_conversation` (`conversation_id`, `delete_flag`, `created_at`),
+  KEY `idx_execution_parent` (`parent_execution_id`, `delete_flag`, `created_at`),
+  KEY `idx_execution_user_status` (`user_id`, `delete_flag`, `status`),
+  CONSTRAINT `fk_execution_conversation` FOREIGN KEY (`conversation_id`)
+    REFERENCES `ai_conversation` (`conversation_id`),
+  CONSTRAINT `fk_execution_parent` FOREIGN KEY (`parent_execution_id`)
+    REFERENCES `ai_agent_execution` (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `ai_conversation_message` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `message_id` VARCHAR(128) COLLATE utf8mb4_bin NOT NULL COMMENT '消息业务标识',
+  `conversation_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '所属业务会话标识',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '消息所属用户标识',
+  `agent_execution_id` BIGINT NOT NULL COMMENT '消息所属执行数据库主键',
+  `role` VARCHAR(32) COLLATE utf8mb4_bin NOT NULL COMMENT '消息角色：user-用户，assistant-助手，tool-工具结果，system-系统，developer-开发者，reasoning-推理',
+  `sequence_no` BIGINT NOT NULL COMMENT '会话范围内的消息顺序号',
+  `payload` JSON NOT NULL COMMENT '消息角色特有字段 JSON',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_conversation_message` (`conversation_id`, `message_id`),
+  UNIQUE KEY `uk_conversation_sequence` (`conversation_id`, `sequence_no`),
+  KEY `idx_message_history` (`conversation_id`, `user_id`, `delete_flag`, `sequence_no`),
+  KEY `idx_message_execution` (`agent_execution_id`, `delete_flag`, `sequence_no`),
+  CONSTRAINT `fk_message_conversation` FOREIGN KEY (`conversation_id`)
+    REFERENCES `ai_conversation` (`conversation_id`),
+  CONSTRAINT `fk_message_execution` FOREIGN KEY (`agent_execution_id`)
+    REFERENCES `ai_agent_execution` (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `ai_memory_file` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '记忆文件所属用户标识',
+  `path` VARCHAR(512) COLLATE utf8mb4_bin NOT NULL COMMENT '用户命名空间内的文件路径',
+  `content` MEDIUMTEXT NOT NULL COMMENT '记忆文件内容',
+  `version` BIGINT NOT NULL COMMENT '文件内容版本号',
+  `last_operation_id` VARCHAR(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '最后一次修改文件的幂等操作标识',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `active_path` VARCHAR(512) COLLATE utf8mb4_bin GENERATED ALWAYS AS (
+    CASE WHEN `delete_flag` = 1 THEN `path` ELSE NULL END
+  ) STORED COMMENT '有效文件路径，用于实现软删除后的路径唯一约束',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_memory_file_active_path` (`user_id`, `active_path`),
+  KEY `idx_memory_file_prefix` (`user_id`, `delete_flag`, `path`(191))
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `ai_memory_operation` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '操作所属用户标识',
+  `operation_id` VARCHAR(128) COLLATE utf8mb4_bin NOT NULL COMMENT '客户端幂等操作标识',
+  `fingerprint` VARCHAR(128) COLLATE utf8mb4_bin NOT NULL COMMENT '操作请求内容指纹',
+  `result_version` BIGINT DEFAULT NULL COMMENT '操作结果版本号，删除操作为空',
+  `existed` TINYINT(1) NOT NULL COMMENT '操作前文件是否存在：1-存在，0-不存在',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_memory_operation` (`user_id`, `operation_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `agent_scheduled_task` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `user_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '任务所属用户标识',
+  `org_code` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '任务创建时的机构快照',
+  `role_id` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '任务创建或编辑时的Ark系统角色快照',
+  `title` VARCHAR(255) NOT NULL COMMENT '任务标题',
+  `prompt` TEXT NOT NULL COMMENT '每次执行使用的自然语言任务提示',
+  `schedule_type` VARCHAR(16) COLLATE utf8mb4_bin NOT NULL COMMENT '调度类型：ONCE、CRON、INTERVAL',
+  `run_at` DATETIME(3) DEFAULT NULL COMMENT '单次执行时间或间隔锚点，UTC',
+  `cron_expression` VARCHAR(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT 'Spring 六字段 cron 表达式',
+  `interval_seconds` BIGINT UNSIGNED DEFAULT NULL COMMENT '固定执行间隔秒数',
+  `timezone` VARCHAR(64) COLLATE utf8mb4_bin NOT NULL COMMENT '任务 IANA 时区',
+  `status` VARCHAR(16) COLLATE utf8mb4_bin NOT NULL COMMENT '任务状态：ACTIVE、PAUSED、COMPLETED',
+  `next_run_at` DATETIME(3) DEFAULT NULL COMMENT '下一次计划执行时间，UTC',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME(3) NOT NULL COMMENT '创建时间，UTC',
+  `updated_at` DATETIME(3) NOT NULL COMMENT '最后更新时间，UTC',
+  PRIMARY KEY (`id`),
+  KEY `idx_scheduled_task_due` (`delete_flag`, `status`, `next_run_at`),
+  KEY `idx_scheduled_task_user` (`user_id`, `delete_flag`, `updated_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
+
+CREATE TABLE IF NOT EXISTS `agent_scheduled_task_run` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '数据库自增主键',
+  `task_id` BIGINT UNSIGNED NOT NULL COMMENT '所属定时任务主键',
+  `scheduled_at` DATETIME(3) NOT NULL COMMENT '本次计划执行时间，UTC',
+  `status` VARCHAR(16) COLLATE utf8mb4_bin NOT NULL COMMENT '运行状态：PENDING、RUNNING、SUCCEEDED、FAILED',
+  `result_payload` LONGTEXT DEFAULT NULL COMMENT 'py-app 返回的标准结果 JSON',
+  `result_conversation_id` VARCHAR(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '用户打开结果后创建的会话标识',
+  `read_flag` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '结果读取标记：1-已打开，0-未打开',
+  `error_code` VARCHAR(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '稳定错误码',
+  `error_message` VARCHAR(512) DEFAULT NULL COMMENT '用户安全错误信息',
+  `execution_token_hash` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL COMMENT '单次运行 token 的 SHA-256 小写十六进制哈希',
+  `execution_token_expires_at` DATETIME(3) DEFAULT NULL COMMENT '单次运行 token 的失效时间，UTC',
+  `started_at` DATETIME(3) DEFAULT NULL COMMENT '实际开始时间，UTC',
+  `finished_at` DATETIME(3) DEFAULT NULL COMMENT '实际结束时间，UTC',
+  `delete_flag` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '删除标记：1-有效，0-已删除',
+  `created_at` DATETIME(3) NOT NULL COMMENT '创建时间，UTC',
+  `updated_at` DATETIME(3) NOT NULL COMMENT '最后更新时间，UTC',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_scheduled_run_occurrence` (`task_id`, `scheduled_at`),
+  UNIQUE KEY `uk_scheduled_run_token_hash` (`execution_token_hash`),
+  KEY `idx_scheduled_run_task` (`task_id`, `delete_flag`, `scheduled_at`),
+  KEY `idx_scheduled_run_status` (`delete_flag`, `status`, `created_at`),
+  KEY `idx_scheduled_run_unread` (`delete_flag`, `status`, `read_flag`, `finished_at`),
+  KEY `idx_scheduled_run_conversation` (`result_conversation_id`),
+  CONSTRAINT `fk_scheduled_run_task` FOREIGN KEY (`task_id`)
+    REFERENCES `agent_scheduled_task` (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

package/ark-control/src/test/java/com/union/control/AgentExecutionServiceTest.java

@@ -0,0 +1,170 @@
+package com.union.control;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.union.control.mapper.AgentExecutionMapper;
+import com.union.control.mapper.ConversationMapper;
+import com.union.control.service.impl.AgentExecutionServiceImpl;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.InOrder;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.inOrder;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+public class AgentExecutionServiceTest {
+    private AgentExecutionServiceImpl service;
+    private AgentExecutionMapper executions;
+    private ConversationMapper conversations;
+
+    @Before
+    public void setUp() {
+        executions = mock(AgentExecutionMapper.class);
+        conversations = mock(ConversationMapper.class);
+        service = new AgentExecutionServiceImpl(executions, conversations, new ObjectMapper());
+        when(conversations.requireOwned("thread-1", TestJson.USER_ID, true)).thenReturn(1L);
+    }
+
+    @Test
+    public void aguiRunLeavesFrontendFeatureValidationToPyApp() {
+        String body = "{\"threadId\":\"thread-1\",\"runId\":\"run-1\"," +
+                "\"messages\":[{\"id\":\"m1\",\"role\":\"user\",\"content\":\"hello\"}]," +
+                "\"state\":{},\"context\":[],\"forwardedProps\":{}," +
+                "\"tools\":[{\"name\":\"unsafe\"}]}";
+        when(conversations.requireOwnedActive("thread-1", TestJson.USER_ID)).thenReturn(1L);
+        when(executions.findExecution(TestJson.USER_ID, "thread-1", "run-1", false))
+                .thenReturn(Collections.singletonList(root("running", null)));
+
+        service.claimAguiRun(TestJson.request(body));
+
+        verify(executions).insertRootExecution("run-1", "thread-1", TestJson.USER_ID);
+    }
+
+    @Test
+    public void aguiRunRejectsAnExistingConversationOwnedByAnotherUser() {
+        String body = "{\"threadId\":\"foreign-thread\",\"runId\":\"run-1\"," +
+                "\"messages\":[],\"state\":{},\"context\":[],\"forwardedProps\":{}}";
+        when(conversations.requireOwnedActive("foreign-thread", TestJson.USER_ID))
+                .thenReturn(null);
+
+        assertThatThrownBy(() -> service.claimAguiRun(TestJson.request(body)))
+                .isInstanceOf(java.util.NoSuchElementException.class);
+        verify(executions, never()).insertRootExecution(
+                "run-1", "foreign-thread", TestJson.USER_ID);
+    }
+
+    @Test
+    public void completionPersistsTheStatusChosenByPyApp() {
+        when(executions.findExecution(TestJson.USER_ID, "thread-1", "run-1", true))
+                .thenReturn(Collections.singletonList(root("running", null)));
+        when(executions.finishExecution(7L, "sdk_terminal", null)).thenReturn(1);
+        Map<String, Object> rootExecution =
+                execution("run-1", null, "UnionCoordinatorAgent", null, null);
+        rootExecution.put("status", "sdk_terminal");
+        Map<String, Object> payload = completion(rootExecution);
+
+        service.completeRun(TestJson.request(payload));
+
+        verify(executions).finishExecution(7L, "sdk_terminal", null);
+    }
+
+    @Test
+    public void completionLocksTheConversationBeforeAllocatingMessageSequences() {
+        when(executions.findExecution(TestJson.USER_ID, "thread-1", "run-1", true))
+                .thenReturn(Collections.singletonList(root("running", null)));
+        when(executions.finishExecution(7L, "completed", null)).thenReturn(1);
+
+        service.completeRun(TestJson.request(completion(
+                execution("run-1", null, "KnowledgeAgent", null, null))));
+
+        InOrder order = inOrder(conversations, executions);
+        order.verify(conversations).requireOwned("thread-1", TestJson.USER_ID, true);
+        order.verify(executions).findExecution(
+                TestJson.USER_ID, "thread-1", "run-1", true);
+        order.verify(conversations).currentMessageSequence("thread-1");
+    }
+
+    @Test
+    public void completionSelectsTheRootAgentWithoutAnExtraCallback() {
+        when(executions.findExecution(TestJson.USER_ID, "thread-1", "run-1", true))
+                .thenReturn(Collections.singletonList(root("running", null)));
+        when(executions.finishExecution(7L, "completed", null)).thenReturn(1);
+        Map<String, Object> payload = completion(
+                execution("run-1", null, "KnowledgeAgent", null, null));
+
+        service.completeRun(TestJson.request(payload));
+
+        verify(executions).updateRootAgent(7L, "KnowledgeAgent");
+        verify(executions).finishExecution(7L, "completed", null);
+    }
+
+    @Test
+    public void completionDoesNotLimitMessageCount() {
+        when(executions.findExecution(TestJson.USER_ID, "thread-1", "run-1", true))
+                .thenReturn(Collections.singletonList(root("running", null)));
+        when(executions.finishExecution(7L, "completed", null)).thenReturn(1);
+        Map<String, Object> payload = completion(
+                execution("run-1", null, "UnionCoordinatorAgent", null, null));
+        List<Map<String, Object>> messages = new ArrayList<>();
+        for (int index = 0; index < 1001; index++) {
+            Map<String, Object> message = new LinkedHashMap<>();
+            message.put("id", "message-" + index);
+            message.put("role", "assistant");
+            message.put("content", "value");
+            Map<String, Object> envelope = new LinkedHashMap<>();
+            envelope.put("runId", "run-1");
+            envelope.put("message", message);
+            messages.add(envelope);
+        }
+        payload.put("messages", messages);
+
+        service.completeRun(TestJson.request(payload));
+
+        verify(conversations).touchConversation("thread-1", TestJson.USER_ID);
+    }
+
+    private static Map<String, Object> completion(Map<String, Object>... executions) {
+        Map<String, Object> payload = new LinkedHashMap<>();
+        payload.put("conversationId", "thread-1");
+        payload.put("runId", "run-1");
+        payload.put("executions", Arrays.asList(executions));
+        payload.put("messages", Collections.emptyList());
+        return payload;
+    }
+
+    private static Map<String, Object> execution(
+            String runId, String parentRunId, String agentName,
+            String callId, String task) {
+        Map<String, Object> execution = new LinkedHashMap<>();
+        execution.put("runId", runId);
+        execution.put("parentRunId", parentRunId);
+        execution.put("agentName", agentName);
+        execution.put("delegationToolCallId", callId);
+        execution.put("task", task);
+        execution.put("status", "completed");
+        execution.put("errorCode", null);
+        return execution;
+    }
+
+    private static Map<String, Object> root(String status, String errorCode) {
+        Map<String, Object> root = new LinkedHashMap<>();
+        root.put("id", 7L);
+        root.put("runId", "run-1");
+        root.put("conversationId", "thread-1");
+        root.put("parentExecutionId", null);
+        root.put("agentName", null);
+        root.put("status", status);
+        root.put("errorCode", errorCode);
+        return root;
+    }
+}