acp-ts 1.2.1 → 1.2.3

package/dist/agentcp.js

@@ -452,6 +452,9 @@ class AgentCP {
             onGroupEvent(groupId, evt) {
                 console.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
             },
+            onDutyDispatch(groupId, context) {
+                console.log(`[Group][DefaultHandler] onDutyDispatch: group=${groupId} original_msg_id=${context.original_msg_id} sender=${context.sender_id}`);
+            },
         };
     }
     /**

package/dist/group/events.d.ts

@@ -2,7 +2,7 @@
  * Group event handler interfaces and dispatch logic.
  * Mirrors Python SDK: agentcp/group/events.py
  */
-import { GroupNotify, GroupEvent, GroupMessageBatch } from './types';
+import { GroupNotify, GroupEvent, GroupMessageBatch, DutyContext } from './types';
 /**
  * Abstract handler for ACP group notifications.
  */
@@ -15,6 +15,7 @@ export interface ACPGroupEventHandler {
     onJoinRequestReceived(groupId: string, agentId: string, message: string): void;
     onGroupMessageBatch(groupId: string, batch: GroupMessageBatch): void;
     onGroupEvent(groupId: string, evt: GroupEvent): void;
+    onDutyDispatch(groupId: string, context: DutyContext): void;
 }
 /**
  * Abstract handler for structured group events (from MSG/Session).

package/dist/group/events.js

@@ -12,7 +12,7 @@ const types_1 = require("./types");
  * Returns true if dispatched, false if unrecognized or handler/notify is null.
  */
 function dispatchAcpNotify(handler, notify) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
     if (handler == null || notify == null) {
         return false;
     }
@@ -41,6 +41,30 @@ function dispatchAcpNotify(handler, notify) {
         else if (event === types_1.NOTIFY_GROUP_EVENT) {
             handler.onGroupEvent(gid, data);
         }
+        else if (event === types_1.NOTIFY_DUTY_DISPATCH) {
+            const context = {
+                needs_dispatch: (_o = data.needs_dispatch) !== null && _o !== void 0 ? _o : false,
+                original_msg_id: (_p = data.original_msg_id) !== null && _p !== void 0 ? _p : 0,
+                sender_id: (_q = data.sender_id) !== null && _q !== void 0 ? _q : "",
+                sender_type: (_r = data.sender_type) !== null && _r !== void 0 ? _r : "",
+                group_member_count: (_s = data.group_member_count) !== null && _s !== void 0 ? _s : 0,
+                online_ai_members: ((_t = data.online_ai_members) !== null && _t !== void 0 ? _t : []).map((m) => {
+                    var _a, _b;
+                    return ({
+                        agent_id: (_a = m.agent_id) !== null && _a !== void 0 ? _a : "",
+                        agent_type: (_b = m.agent_type) !== null && _b !== void 0 ? _b : "",
+                    });
+                }),
+                human_members: ((_u = data.human_members) !== null && _u !== void 0 ? _u : []).map((m) => {
+                    var _a, _b;
+                    return ({
+                        agent_id: (_a = m.agent_id) !== null && _a !== void 0 ? _a : "",
+                        agent_type: (_b = m.agent_type) !== null && _b !== void 0 ? _b : "",
+                    });
+                }),
+            };
+            handler.onDutyDispatch(gid, context);
+        }
         else {
             return false;
         }

package/dist/group/index.d.ts

@@ -2,7 +2,7 @@
  * ACP Group Operations package.
  * Mirrors Python SDK: agentcp/group/__init__.py
  */
-export { GroupErrorCode, GroupError, GroupRequest, GroupResponse, GroupNotify, buildGroupRequest, groupRequestToJson, parseGroupResponse, parseGroupNotify, GroupMessage, GroupEvent, MsgCursor, EventCursor, CursorState, createMsgCursor, createEventCursor, CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, MembershipInfo, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, NOTIFY_NEW_MESSAGE, NOTIFY_NEW_EVENT, NOTIFY_GROUP_INVITE, NOTIFY_JOIN_APPROVED, NOTIFY_JOIN_REJECTED, NOTIFY_JOIN_REQUEST_RECEIVED, NOTIFY_GROUP_EVENT, EVENT_MEMBER_JOINED, EVENT_MEMBER_REMOVED, EVENT_MEMBER_LEFT, EVENT_MEMBER_BANNED, EVENT_META_UPDATED, EVENT_RULES_UPDATED, EVENT_ANNOUNCEMENT_UPDATED, EVENT_GROUP_DISSOLVED, EVENT_MASTER_TRANSFERRED, EVENT_GROUP_SUSPENDED, EVENT_GROUP_RESUMED, EVENT_MEMBER_UNBANNED, EVENT_JOIN_REQUIREMENTS_UPDATED, EVENT_INVITE_CODE_CREATED, EVENT_INVITE_CODE_REVOKED, ACTION_MESSAGE_BATCH_PUSH, GroupMessageBatch, } from './types';
+export { GroupErrorCode, GroupError, GroupRequest, GroupResponse, GroupNotify, buildGroupRequest, groupRequestToJson, parseGroupResponse, parseGroupNotify, GroupMessage, GroupEvent, MsgCursor, EventCursor, CursorState, createMsgCursor, createEventCursor, CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, RequestJoinResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, MembershipInfo, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, NOTIFY_NEW_MESSAGE, NOTIFY_NEW_EVENT, NOTIFY_GROUP_INVITE, NOTIFY_JOIN_APPROVED, NOTIFY_JOIN_REJECTED, NOTIFY_JOIN_REQUEST_RECEIVED, NOTIFY_GROUP_EVENT, NOTIFY_DUTY_DISPATCH, EVENT_MEMBER_JOINED, EVENT_MEMBER_REMOVED, EVENT_MEMBER_LEFT, EVENT_MEMBER_BANNED, EVENT_META_UPDATED, EVENT_RULES_UPDATED, EVENT_ANNOUNCEMENT_UPDATED, EVENT_GROUP_DISSOLVED, EVENT_MASTER_TRANSFERRED, EVENT_GROUP_SUSPENDED, EVENT_GROUP_RESUMED, EVENT_MEMBER_UNBANNED, EVENT_JOIN_REQUIREMENTS_UPDATED, EVENT_INVITE_CODE_CREATED, EVENT_INVITE_CODE_REVOKED, ACTION_MESSAGE_BATCH_PUSH, GroupMessageBatch, DutyMemberInfo, DutyContext, DispatchDecisionParams, DispatchMetadata, DutyConfig, DutyState, DutyStatusResp, } from './types';
 export { ACPGroupClient, SendFunc } from './client';
 export { GroupOperations, SyncHandler } from './operations';
 export { ACPGroupEventHandler, EventProcessor, dispatchAcpNotify, dispatchEvent, } from './events';

package/dist/group/index.js

@@ -4,7 +4,7 @@
  * Mirrors Python SDK: agentcp/group/__init__.py
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GroupMessageStore = exports.LocalCursorStore = exports.dispatchAcpNotify = exports.GroupOperations = exports.ACPGroupClient = exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.createEventCursor = exports.createMsgCursor = exports.parseGroupNotify = exports.parseGroupResponse = exports.groupRequestToJson = exports.buildGroupRequest = exports.GroupError = exports.GroupErrorCode = void 0;
+exports.GroupMessageStore = exports.LocalCursorStore = exports.dispatchAcpNotify = exports.GroupOperations = exports.ACPGroupClient = exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_DUTY_DISPATCH = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.createEventCursor = exports.createMsgCursor = exports.parseGroupNotify = exports.parseGroupResponse = exports.groupRequestToJson = exports.buildGroupRequest = exports.GroupError = exports.GroupErrorCode = void 0;
 // Types
 var types_1 = require("./types");
 Object.defineProperty(exports, "GroupErrorCode", { enumerable: true, get: function () { return types_1.GroupErrorCode; } });
@@ -23,6 +23,7 @@ Object.defineProperty(exports, "NOTIFY_JOIN_APPROVED", { enumerable: true, get:
 Object.defineProperty(exports, "NOTIFY_JOIN_REJECTED", { enumerable: true, get: function () { return types_1.NOTIFY_JOIN_REJECTED; } });
 Object.defineProperty(exports, "NOTIFY_JOIN_REQUEST_RECEIVED", { enumerable: true, get: function () { return types_1.NOTIFY_JOIN_REQUEST_RECEIVED; } });
 Object.defineProperty(exports, "NOTIFY_GROUP_EVENT", { enumerable: true, get: function () { return types_1.NOTIFY_GROUP_EVENT; } });
+Object.defineProperty(exports, "NOTIFY_DUTY_DISPATCH", { enumerable: true, get: function () { return types_1.NOTIFY_DUTY_DISPATCH; } });
 // Group event type constants
 Object.defineProperty(exports, "EVENT_MEMBER_JOINED", { enumerable: true, get: function () { return types_1.EVENT_MEMBER_JOINED; } });
 Object.defineProperty(exports, "EVENT_MEMBER_REMOVED", { enumerable: true, get: function () { return types_1.EVENT_MEMBER_REMOVED; } });

package/dist/group/operations.d.ts

@@ -3,7 +3,7 @@
  * Mirrors Python SDK: agentcp/group/operations.py
  */
 import { ACPGroupClient } from './client';
-import { CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp } from './types';
+import { CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, RequestJoinResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, DutyConfig, DutyStatusResp, DispatchDecisionParams } from './types';
 /**
  * Callback interface for syncGroup.
  */
@@ -30,18 +30,20 @@ export declare class GroupOperations {
     /**
      * 通过群聊链接加入群组。
      * - 提供 inviteCode 时：免审核，直接通过邀请码加入
-     * - 不提供 inviteCode 时：提交加入申请，等待管理员审核
+     * - 不提供 inviteCode 时：
+     *   - 公开群：直接加入，返回 status="joined"
+     *   - 私密群：提交加入申请，返回 status="pending"
      *
      * @param groupUrl 群聊链接，如 "https://group.agentcp.io/<group_id>"
      * @param options 可选参数
      * @param options.inviteCode 邀请码（免审核加入）
-     * @param options.message 申请消息（审核模式下使用）
-     * @returns 审核模式返回 request_id，免审核模式返回空字符串
+     * @param options.message 申请消息（私密群审核模式下使用）
+     * @returns RequestJoinResp，包含 status 和 request_id
      */
     joinByUrl(groupUrl: string, options?: {
         inviteCode?: string;
         message?: string;
-    }): Promise<string>;
+    }): Promise<RequestJoinResp>;
     /**
      * 注册上线，告知 group.ap 当前客户端在线，可以接收消息推送。
      * 客户端每次启动或重新连接时调用一次即可。
@@ -85,7 +87,7 @@ export declare class GroupOperations {
     banAgent(targetAid: string, groupId: string, agentId: string, reason?: string, expiresAt?: number): Promise<void>;
     unbanAgent(targetAid: string, groupId: string, agentId: string): Promise<void>;
     getBanlist(targetAid: string, groupId: string): Promise<BanlistResp>;
-    requestJoin(targetAid: string, groupId: string, message?: string): Promise<string>;
+    requestJoin(targetAid: string, groupId: string, message?: string): Promise<RequestJoinResp>;
     reviewJoinRequest(targetAid: string, groupId: string, agentId: string, action: string, reason?: string): Promise<void>;
     batchReviewJoinRequests(targetAid: string, groupId: string, agentIds: string[], action: string, reason?: string): Promise<BatchReviewResp>;
     getPendingRequests(targetAid: string, groupId: string): Promise<PendingRequestsResp>;
@@ -132,4 +134,24 @@ export declare class GroupOperations {
     getFile(targetAid: string, groupId: string, file: string, offset?: number): Promise<GetFileResp>;
     getSummary(targetAid: string, groupId: string, date: string): Promise<GetSummaryResp>;
     getMetrics(targetAid: string): Promise<GetMetricsResp>;
+    /**
+     * 更新值班配置。权限要求：creator 或 admin。
+     */
+    updateDutyConfig(targetAid: string, groupId: string, config: Partial<DutyConfig>): Promise<void>;
+    /**
+     * 快捷设置固定值班 Agent 列表（自动切换为 fixed 模式）。
+     */
+    setFixedAgents(targetAid: string, groupId: string, agents: string[]): Promise<void>;
+    /**
+     * 获取值班状态，包含 config 和 state。
+     */
+    getDutyStatus(targetAid: string, groupId: string): Promise<DutyStatusResp>;
+    /**
+     * 值班 Agent 提交仲裁决策。
+     */
+    dispatchDecision(targetAid: string, groupId: string, params: DispatchDecisionParams): Promise<void>;
+    /**
+     * 重新获取所有成员的 agent.md 并更新 AgentType。
+     */
+    refreshMemberTypes(targetAid: string, groupId: string): Promise<void>;
 }

package/dist/group/operations.js

@@ -41,20 +41,22 @@ class GroupOperations {
     /**
      * 通过群聊链接加入群组。
      * - 提供 inviteCode 时：免审核，直接通过邀请码加入
-     * - 不提供 inviteCode 时：提交加入申请，等待管理员审核
+     * - 不提供 inviteCode 时：
+     *   - 公开群：直接加入，返回 status="joined"
+     *   - 私密群：提交加入申请，返回 status="pending"
      *
      * @param groupUrl 群聊链接，如 "https://group.agentcp.io/<group_id>"
      * @param options 可选参数
      * @param options.inviteCode 邀请码（免审核加入）
-     * @param options.message 申请消息（审核模式下使用）
-     * @returns 审核模式返回 request_id，免审核模式返回空字符串
+     * @param options.message 申请消息（私密群审核模式下使用）
+     * @returns RequestJoinResp，包含 status 和 request_id
      */
     async joinByUrl(groupUrl, options) {
         var _a;
         const { targetAid, groupId } = GroupOperations.parseGroupUrl(groupUrl);
         if (options === null || options === void 0 ? void 0 : options.inviteCode) {
             await this.useInviteCode(targetAid, groupId, options.inviteCode);
-            return '';
+            return { status: 'joined', request_id: '' };
         }
         return this.requestJoin(targetAid, groupId, (_a = options === null || options === void 0 ? void 0 : options.message) !== null && _a !== void 0 ? _a : '');
     }
@@ -268,14 +270,14 @@ class GroupOperations {
         return { banned: (_a = d.banned) !== null && _a !== void 0 ? _a : [] };
     }
     async requestJoin(targetAid, groupId, message = "") {
-        var _a;
+        var _a, _b;
         const params = {};
         if (message)
             params.message = message;
         const resp = await this._client.sendRequest(targetAid, groupId, "request_join", Object.keys(params).length > 0 ? params : null);
         this._check(resp, "request_join");
         const d = resp.data || {};
-        return (_a = d.request_id) !== null && _a !== void 0 ? _a : "";
+        return { status: (_a = d.status) !== null && _a !== void 0 ? _a : "pending", request_id: (_b = d.request_id) !== null && _b !== void 0 ? _b : "" };
     }
     async reviewJoinRequest(targetAid, groupId, agentId, action, reason = "") {
         const params = { agent_id: agentId, action };
@@ -616,5 +618,59 @@ class GroupOperations {
             sys_mb: (_c = d.sys_mb) !== null && _c !== void 0 ? _c : 0, gc_cycles: (_d = d.gc_cycles) !== null && _d !== void 0 ? _d : 0,
         };
     }
+    // ============================================================
+    // Duty (值班) Operations
+    // ============================================================
+    /**
+     * 更新值班配置。权限要求：creator 或 admin。
+     */
+    async updateDutyConfig(targetAid, groupId, config) {
+        const params = {};
+        if (config.mode != null)
+            params.mode = config.mode;
+        if (config.rotation_strategy != null)
+            params.rotation_strategy = config.rotation_strategy;
+        if (config.shift_duration_ms != null)
+            params.shift_duration_ms = config.shift_duration_ms;
+        if (config.max_messages_per_shift != null)
+            params.max_messages_per_shift = config.max_messages_per_shift;
+        if (config.dispatch_timeout_ms != null)
+            params.dispatch_timeout_ms = config.dispatch_timeout_ms;
+        if (config.timeout_fallback != null)
+            params.timeout_fallback = config.timeout_fallback;
+        const resp = await this._client.sendRequest(targetAid, groupId, "update_duty_config", params);
+        this._check(resp, "update_duty_config");
+    }
+    /**
+     * 快捷设置固定值班 Agent 列表（自动切换为 fixed 模式）。
+     */
+    async setFixedAgents(targetAid, groupId, agents) {
+        const resp = await this._client.sendRequest(targetAid, groupId, "set_fixed_agents", { agents });
+        this._check(resp, "set_fixed_agents");
+    }
+    /**
+     * 获取值班状态，包含 config 和 state。
+     */
+    async getDutyStatus(targetAid, groupId) {
+        var _a, _b;
+        const resp = await this._client.sendRequest(targetAid, groupId, "get_duty_status", null);
+        this._check(resp, "get_duty_status");
+        const d = resp.data || {};
+        return { config: (_a = d.config) !== null && _a !== void 0 ? _a : {}, state: (_b = d.state) !== null && _b !== void 0 ? _b : {} };
+    }
+    /**
+     * 值班 Agent 提交仲裁决策。
+     */
+    async dispatchDecision(targetAid, groupId, params) {
+        const resp = await this._client.sendRequest(targetAid, groupId, "dispatch_decision", params);
+        this._check(resp, "dispatch_decision");
+    }
+    /**
+     * 重新获取所有成员的 agent.md 并更新 AgentType。
+     */
+    async refreshMemberTypes(targetAid, groupId) {
+        const resp = await this._client.sendRequest(targetAid, groupId, "refresh_member_types", null);
+        this._check(resp, "refresh_member_types");
+    }
 }
 exports.GroupOperations = GroupOperations;

package/dist/group/types.d.ts

@@ -17,7 +17,13 @@ export declare enum GroupErrorCode {
     INVITE_CODE_INVALID = 1011,
     REQUEST_EXISTS = 1012,
     BROADCAST_CONFLICT = 1013,
-    ACTION_NOT_IMPL = 1099
+    ACTION_NOT_IMPL = 1099,
+    DUTY_NOT_ENABLED = 1020,
+    NOT_DUTY_AGENT = 1021,
+    DISPATCH_NOT_FOUND = 1022,
+    INVALID_DECISION = 1023,
+    AGENT_MD_NOT_FOUND = 1024,
+    AGENT_MD_INVALID = 1025
 }
 export declare class GroupError extends Error {
     action: string;
@@ -120,6 +126,11 @@ export interface GroupInfoResp {
 export interface BanlistResp {
     banned: Record<string, any>[];
 }
+export interface RequestJoinResp {
+    /** "joined" = 已直接加入（公开群）, "pending" = 等待审核（私密群） */
+    status: string;
+    request_id: string;
+}
 export interface BatchReviewResp {
     processed: number;
     total: number;
@@ -248,6 +259,7 @@ export declare const NOTIFY_JOIN_APPROVED = "join_approved";
 export declare const NOTIFY_JOIN_REJECTED = "join_rejected";
 export declare const NOTIFY_JOIN_REQUEST_RECEIVED = "join_request_received";
 export declare const NOTIFY_GROUP_EVENT = "group_event";
+export declare const NOTIFY_DUTY_DISPATCH = "duty_dispatch";
 export declare const EVENT_MEMBER_JOINED = "member_joined";
 export declare const EVENT_MEMBER_REMOVED = "member_removed";
 export declare const EVENT_MEMBER_LEFT = "member_left";
@@ -263,6 +275,49 @@ export declare const EVENT_MEMBER_UNBANNED = "member_unbanned";
 export declare const EVENT_JOIN_REQUIREMENTS_UPDATED = "join_requirements_updated";
 export declare const EVENT_INVITE_CODE_CREATED = "invite_code_created";
 export declare const EVENT_INVITE_CODE_REVOKED = "invite_code_revoked";
+export interface DutyMemberInfo {
+    agent_id: string;
+    agent_type: string;
+}
+export interface DutyContext {
+    needs_dispatch: boolean;
+    original_msg_id: number;
+    sender_id: string;
+    sender_type: string;
+    group_member_count: number;
+    online_ai_members: DutyMemberInfo[];
+    human_members: DutyMemberInfo[];
+}
+export interface DispatchDecisionParams {
+    original_msg_id: number;
+    type: "broadcast" | "selective" | "suppress";
+    hint?: string;
+    reply_mode?: string;
+}
+export interface DispatchMetadata {
+    type: string;
+    hint: string;
+    reply_mode: string;
+}
+export interface DutyConfig {
+    mode: "none" | "fixed" | "rotation";
+    rotation_strategy?: "round_robin" | "random";
+    shift_duration_ms?: number;
+    max_messages_per_shift?: number;
+    dispatch_timeout_ms?: number;
+    timeout_fallback?: "broadcast" | "next_duty";
+    agents?: string[];
+}
+export interface DutyState {
+    current_duty_agent?: string;
+    shift_start_time?: number;
+    messages_in_shift?: number;
+    [key: string]: any;
+}
+export interface DutyStatusResp {
+    config: DutyConfig;
+    state: DutyState;
+}
 export declare const ACTION_MESSAGE_BATCH_PUSH = "message_batch_push";
 export interface GroupMessageBatch {
     messages: GroupMessage[];

package/dist/group/types.js

@@ -4,7 +4,7 @@
  * Mirrors Python SDK: agentcp/group/types.py
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.GroupError = exports.GroupErrorCode = void 0;
+exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_DUTY_DISPATCH = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.GroupError = exports.GroupErrorCode = void 0;
 exports.buildGroupRequest = buildGroupRequest;
 exports.groupRequestToJson = groupRequestToJson;
 exports.parseGroupResponse = parseGroupResponse;
@@ -31,6 +31,13 @@ var GroupErrorCode;
     GroupErrorCode[GroupErrorCode["REQUEST_EXISTS"] = 1012] = "REQUEST_EXISTS";
     GroupErrorCode[GroupErrorCode["BROADCAST_CONFLICT"] = 1013] = "BROADCAST_CONFLICT";
     GroupErrorCode[GroupErrorCode["ACTION_NOT_IMPL"] = 1099] = "ACTION_NOT_IMPL";
+    // Duty error codes
+    GroupErrorCode[GroupErrorCode["DUTY_NOT_ENABLED"] = 1020] = "DUTY_NOT_ENABLED";
+    GroupErrorCode[GroupErrorCode["NOT_DUTY_AGENT"] = 1021] = "NOT_DUTY_AGENT";
+    GroupErrorCode[GroupErrorCode["DISPATCH_NOT_FOUND"] = 1022] = "DISPATCH_NOT_FOUND";
+    GroupErrorCode[GroupErrorCode["INVALID_DECISION"] = 1023] = "INVALID_DECISION";
+    GroupErrorCode[GroupErrorCode["AGENT_MD_NOT_FOUND"] = 1024] = "AGENT_MD_NOT_FOUND";
+    GroupErrorCode[GroupErrorCode["AGENT_MD_INVALID"] = 1025] = "AGENT_MD_INVALID";
 })(GroupErrorCode || (exports.GroupErrorCode = GroupErrorCode = {}));
 const CODE_MESSAGES = {
     0: "success",
@@ -47,6 +54,12 @@ const CODE_MESSAGES = {
     1011: "invite code invalid",
     1012: "request exists",
     1013: "broadcast conflict",
+    1020: "duty not enabled",
+    1021: "not duty agent",
+    1022: "dispatch not found",
+    1023: "invalid decision",
+    1024: "agent.md not found",
+    1025: "agent.md invalid",
     1099: "action not implemented",
 };
 class GroupError extends Error {
@@ -121,6 +134,7 @@ exports.NOTIFY_JOIN_APPROVED = "join_approved";
 exports.NOTIFY_JOIN_REJECTED = "join_rejected";
 exports.NOTIFY_JOIN_REQUEST_RECEIVED = "join_request_received";
 exports.NOTIFY_GROUP_EVENT = "group_event";
+exports.NOTIFY_DUTY_DISPATCH = "duty_dispatch";
 // Group Event Type Constants
 exports.EVENT_MEMBER_JOINED = "member_joined";
 exports.EVENT_MEMBER_REMOVED = "member_removed";