@ganglion/xacpx 0.24.5-beta.0 → 0.24.5

package/dist/bots/bot-types.d.ts

@@ -0,0 +1,35 @@
+export type BotRuntimeScope = "bot-direct" | "group-member" | "group-controller";
+export interface BotProfile {
+    id: string;
+    name: string;
+    avatar?: string;
+    role?: string;
+    instructions?: string;
+    agent: string;
+    workspace: string;
+    cwd?: string;
+    model?: string;
+    effort?: string;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BotRuntimeBindingBase {
+    id: string;
+    conversationId: string;
+    topicId: string;
+    logicalSessionId: string;
+    sessionAlias: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type BotRuntimeBinding = (BotRuntimeBindingBase & {
+    scope: "bot-direct";
+    botId: string;
+}) | (BotRuntimeBindingBase & {
+    scope: "group-member";
+    botId: string;
+}) | (BotRuntimeBindingBase & {
+    scope: "group-controller";
+});
+export {};

package/dist/cli.js

@@ -30373,7 +30373,11 @@ function createEmptyState() {
     chat_contexts: {},
     native_session_lists: {},
     orchestration: createEmptyOrchestrationState(),
-    scheduled_tasks: {}
+    scheduled_tasks: {},
+    bots: {},
+    conversations: {},
+    conversation_topics: {},
+    bot_runtime_bindings: {}
   };
 }
 var init_types4 = () => {};
@@ -30730,7 +30734,13 @@ function isSessionRecord(value) {
   if (!isRecord4(value)) {
     return false;
   }
-  return isString(value.alias) && isString(value.agent) && isString(value.workspace) && isString(value.transport_session) && (value.logical_session_id === undefined || isLogicalSessionId(value.logical_session_id)) && isSessionSource(value.source) && isOptionalString(value.agent_session_id) && isOptionalString(value.agent_session_title) && isOptionalString(value.agent_session_updated_at) && isOptionalString(value.attached_at) && isOptionalString(value.transport_agent_command) && isOptionalString(value.transport_acpx_agent) && (value.transport_agent_argv === undefined || isStringArray(value.transport_agent_argv)) && (value.transport_engine === undefined || value.transport_engine === "cli" || value.transport_engine === "runtime") && isOptionalString(value.mode_id) && isOptionalString(value.effort) && (value.reply_mode === undefined || isReplyMode2(value.reply_mode)) && isString(value.created_at) && isString(value.last_used_at);
+  return isString(value.alias) && isString(value.agent) && isString(value.workspace) && isString(value.transport_session) && (value.logical_session_id === undefined || isLogicalSessionId(value.logical_session_id)) && isSessionSource(value.source) && isOptionalString(value.agent_session_id) && isOptionalString(value.agent_session_title) && isOptionalString(value.agent_session_updated_at) && isOptionalString(value.attached_at) && isOptionalString(value.transport_agent_command) && isOptionalString(value.transport_acpx_agent) && (value.transport_agent_argv === undefined || isStringArray(value.transport_agent_argv)) && (value.transport_engine === undefined || value.transport_engine === "cli" || value.transport_engine === "runtime") && isOptionalString(value.mode_id) && isOptionalString(value.effort) && (value.reply_mode === undefined || isReplyMode2(value.reply_mode)) && isString(value.created_at) && isString(value.last_used_at) && (value.owner === undefined || isLogicalSessionOwner(value.owner));
+}
+function isLogicalSessionOwner(value) {
+  if (!isRecord4(value)) {
+    return false;
+  }
+  return (value.kind === "bot-direct" || value.kind === "group-member" || value.kind === "group-controller") && isString(value.bindingId) && value.bindingId.length > 0;
 }
 function parseSessions(raw, dropped, migrated) {
   const sessions = {};
@@ -30822,6 +30832,102 @@ function parseScheduledTasks(raw, dropped) {
   }
   return tasks;
 }
+function isBotProfile(value) {
+  if (!isRecord4(value)) {
+    return false;
+  }
+  return isString(value.id) && isString(value.name) && isOptionalString(value.avatar) && isOptionalString(value.role) && isOptionalString(value.instructions) && isString(value.agent) && isString(value.workspace) && isOptionalString(value.cwd) && isOptionalString(value.model) && isOptionalString(value.effort) && typeof value.enabled === "boolean" && isString(value.createdAt) && isString(value.updatedAt);
+}
+function parseBotProfiles(raw, dropped) {
+  const source = sectionRecord(raw, "bots", dropped);
+  const bots = {};
+  for (const [id, value] of Object.entries(source)) {
+    if (!isBotProfile(value) || value.id !== id) {
+      dropped.push({ section: "bots", key: id, reason: "malformed bot profile" });
+      continue;
+    }
+    bots[id] = value;
+  }
+  return bots;
+}
+function isUniqueStringArray(value) {
+  return isStringArray(value) && new Set(value).size === value.length;
+}
+function isConversationRecord(value) {
+  if (!isRecord4(value)) {
+    return false;
+  }
+  if (!isString(value.id) || !isString(value.title) || !isOptionalString(value.description) || !isUniqueStringArray(value.botIds) || !isOptionalString(value.leadBotId) || !isString(value.createdAt) || !isString(value.updatedAt)) {
+    return false;
+  }
+  if (value.leadBotId !== undefined && !value.botIds.includes(value.leadBotId)) {
+    return false;
+  }
+  if (value.kind === "bot") {
+    return value.botIds.length === 1;
+  }
+  if (value.kind === "group") {
+    return value.botIds.length >= 2;
+  }
+  return false;
+}
+function parseConversations(raw, dropped) {
+  const source = sectionRecord(raw, "conversations", dropped);
+  const conversations = {};
+  for (const [id, value] of Object.entries(source)) {
+    if (!isConversationRecord(value) || value.id !== id) {
+      dropped.push({ section: "conversations", key: id, reason: "malformed conversation record" });
+      continue;
+    }
+    conversations[id] = value;
+  }
+  return conversations;
+}
+function isConversationTopic(value) {
+  if (!isRecord4(value)) {
+    return false;
+  }
+  return isString(value.id) && isString(value.conversationId) && isString(value.title) && (value.status === "active" || value.status === "archived") && isString(value.createdAt) && isString(value.updatedAt);
+}
+function parseConversationTopics(raw, dropped) {
+  const source = sectionRecord(raw, "conversation_topics", dropped);
+  const topics = {};
+  for (const [id, value] of Object.entries(source)) {
+    if (!isConversationTopic(value) || value.id !== id) {
+      dropped.push({ section: "conversation_topics", key: id, reason: "malformed conversation topic" });
+      continue;
+    }
+    topics[id] = value;
+  }
+  return topics;
+}
+function isBotRuntimeBinding(value) {
+  if (!isRecord4(value)) {
+    return false;
+  }
+  if (!isString(value.id) || !isString(value.conversationId) || !isString(value.topicId) || !isString(value.logicalSessionId) || !isString(value.sessionAlias) || !isString(value.createdAt) || !isString(value.updatedAt)) {
+    return false;
+  }
+  if (value.scope === "bot-direct" || value.scope === "group-member") {
+    return isString(value.botId) && value.botId.length > 0;
+  }
+  if (value.scope === "group-controller") {
+    return value.botId === undefined;
+  }
+  return false;
+}
+function parseBotRuntimeBindings(raw, dropped) {
+  const source = sectionRecord(raw, "bot_runtime_bindings", dropped);
+  const bindings = {};
+  for (const [id, value] of Object.entries(source)) {
+    if (!isBotRuntimeBinding(value) || value.id !== id) {
+      dropped.push({ section: "bot_runtime_bindings", key: id, reason: "malformed bot runtime binding" });
+      continue;
+    }
+    bindings[id] = value;
+  }
+  return bindings;
+}
 function parseState(raw, path3, dropped = [], migrated = []) {
   if (!isRecord4(raw)) {
     throw new Error(`state file "${path3}" must contain a JSON object`);
@@ -30834,7 +30940,11 @@ function parseState(raw, path3, dropped = [], migrated = []) {
     chat_contexts: parseChatContexts(sectionRecord(raw.chat_contexts, "chat_contexts", dropped), dropped),
     native_session_lists: parseNativeSessionLists(raw.native_session_lists),
     orchestration: orchestration3,
-    scheduled_tasks: parseScheduledTasks(raw.scheduled_tasks, dropped)
+    scheduled_tasks: parseScheduledTasks(raw.scheduled_tasks, dropped),
+    bots: parseBotProfiles(raw.bots, dropped),
+    conversations: parseConversations(raw.conversations, dropped),
+    conversation_topics: parseConversationTopics(raw.conversation_topics, dropped),
+    bot_runtime_bindings: parseBotRuntimeBindings(raw.bot_runtime_bindings, dropped)
   };
 }
 function repairExternalCoordinatorIdentityCollisions(sessions, orchestration3, dropped) {
@@ -54938,6 +55048,10 @@ function replaceRuntimeState(target, source) {
   target.chat_contexts = source.chat_contexts;
   target.orchestration = source.orchestration;
   target.scheduled_tasks = source.scheduled_tasks;
+  target.bots = source.bots;
+  target.conversations = source.conversations;
+  target.conversation_topics = source.conversation_topics;
+  target.bot_runtime_bindings = source.bot_runtime_bindings;
 }
 
 // src/sessions/transport-engine.ts
@@ -55139,8 +55253,8 @@ class SessionService {
       ...this.permissionInteractionCapable !== undefined ? { permissionInteractionCapable: this.permissionInteractionCapable } : {}
     }).engine;
   }
-  async createSession(alias, agent3, workspace3) {
-    return await this.createLogicalSession(alias, agent3, workspace3, `${workspace3}:${alias}`);
+  async createSession(alias, agent3, workspace3, options) {
+    return await this.createLogicalSession(alias, agent3, workspace3, `${workspace3}:${alias}`, undefined, undefined, undefined, undefined, options);
   }
   listAllResolvedSessions() {
     const seen = new Set;
@@ -55547,6 +55661,9 @@ class SessionService {
   getLogicalSessionRecord(alias) {
     return this.state.sessions[alias] ?? null;
   }
+  getLogicalSessionById(logicalSessionId) {
+    return Object.values(this.state.sessions).find((session3) => session3.logical_session_id === logicalSessionId) ?? null;
+  }
   listLogicalSessionRecords() {
     return Object.values(this.state.sessions);
   }
@@ -56166,7 +56283,7 @@ class SessionService {
     }
     return input.sameAgentExistingEngine ?? siblingEngine ?? input.fallback();
   }
-  async createLogicalSession(alias, agent3, workspace3, transportSession, transportAgentCommand, native, transportAcpxAgent, transportAgentArgv) {
+  async createLogicalSession(alias, agent3, workspace3, transportSession, transportAgentCommand, native, transportAcpxAgent, transportAgentArgv, extras) {
     return await this.mutate(async () => {
       this.validateSession(alias, agent3, workspace3);
       if (Object.keys(this.state.orchestration.externalCoordinators).some((coordinatorSession) => sameCoordinatorSession(coordinatorSession, transportSession))) {
@@ -56191,8 +56308,8 @@ class SessionService {
         ...transportAcpxAgent ? { transport_acpx_agent: transportAcpxAgent } : sameAgentExisting?.transport_acpx_agent ? { transport_acpx_agent: sameAgentExisting.transport_acpx_agent } : {},
         ...transportAgentArgv && transportAgentArgv.length > 0 ? { transport_agent_argv: [...transportAgentArgv] } : sameAgentExisting?.transport_agent_argv ? { transport_agent_argv: [...sameAgentExisting.transport_agent_argv] } : {},
         mode_id: sameAgentExisting?.mode_id,
-        model: sameAgentExisting?.model,
-        effort: sameAgentExisting?.effort,
+        model: extras?.model ?? sameAgentExisting?.model,
+        effort: extras?.effort ?? sameAgentExisting?.effort,
         reply_mode: sameAgentExisting?.reply_mode,
         display_name: sameAgentExisting?.display_name,
         transport_engine: this.resolveEngineWithPhysicalInheritance({
@@ -56206,7 +56323,8 @@ class SessionService {
           ...sameAgentExisting ? { sameAgentExisting } : {}
         }),
         created_at: existingSession?.created_at ?? now,
-        last_used_at: now
+        last_used_at: now,
+        ...extras?.owner ? { owner: extras.owner } : {}
       };
       const nextState = structuredClone(this.state);
       nextState.sessions[alias] = session3;

package/dist/conversations/conversation-types.d.ts

@@ -0,0 +1,51 @@
+export type ConversationKind = "bot" | "group";
+export type ConversationTopicStatus = "active" | "archived";
+export type ConversationMessageRole = "human" | "bot" | "system";
+export type GroupTurnOrigin = "human-explicit" | "controller" | "handoff" | "recovery";
+export type GroupTurnState = "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface ConversationRecord {
+    id: string;
+    kind: ConversationKind;
+    title: string;
+    description?: string;
+    botIds: string[];
+    leadBotId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConversationTopic {
+    id: string;
+    conversationId: string;
+    title: string;
+    status: ConversationTopicStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConversationMessage {
+    id: string;
+    conversationId: string;
+    topicId: string;
+    role: ConversationMessageRole;
+    senderBotId?: string;
+    recipients?: string[];
+    content: string;
+    replyTo?: string;
+    createdAt: string;
+    sourceTurn?: {
+        sessionAlias: string;
+        turnId?: string;
+    };
+}
+export interface GroupTurnRecord {
+    id: string;
+    conversationId: string;
+    topicId: string;
+    botId: string;
+    sessionAlias: string;
+    triggerMessageIds: string[];
+    origin: GroupTurnOrigin;
+    state: GroupTurnState;
+    createdAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+}

package/dist/sessions/session-service.d.ts

@@ -1,7 +1,7 @@
 import type { AppConfig } from "../config/types";
 import { AsyncMutex } from "../orchestration/async-mutex";
 import type { StateStore } from "../state/state-store";
-import type { AppState, BackgroundResult, LogicalSession, SessionTransportEngine } from "../state/types";
+import type { AppState, BackgroundResult, LogicalSession, LogicalSessionOwner, SessionTransportEngine } from "../state/types";
 import type { SessionResourceLifecyclePublishInput } from "./session-resource-catalog";
 import type { AgentSession, ResolvedSession } from "../transport/types";
 import type { ReapTarget } from "../transport/queue-owner-reaper";
@@ -125,7 +125,11 @@ export declare class SessionService {
         agent: string;
         workspace: string;
     }): SessionTransportEngine;
-    createSession(alias: string, agent: string, workspace: string): Promise<ResolvedSession>;
+    createSession(alias: string, agent: string, workspace: string, options?: {
+        owner?: LogicalSessionOwner;
+        model?: string;
+        effort?: string;
+    }): Promise<ResolvedSession>;
     /**
      * All currently-known logical sessions resolved to transport sessions, deduped by
      * the composite identity acpx keys its session records on (agent + agent command +
@@ -250,6 +254,7 @@ export declare class SessionService {
      * does not carry (immutable logical_session_id, archived flag).
      */
     getLogicalSessionRecord(alias: string): LogicalSession | null;
+    getLogicalSessionById(logicalSessionId: string): LogicalSession | null;
     /** Read-only view of every persisted logical session record, across all channels. */
     listLogicalSessionRecords(): LogicalSession[];
     setCurrentSessionMode(chatKey: string, modeId: string | undefined): Promise<void>;

package/dist/state/types.d.ts

@@ -1,7 +1,13 @@
+import type { BotProfile, BotRuntimeBinding } from "../bots/bot-types";
+import type { ConversationRecord, ConversationTopic } from "../conversations/conversation-types";
 import { type OrchestrationState } from "../orchestration/orchestration-types";
 import type { ScheduledTaskRecord } from "../scheduled/scheduled-types";
 export type SessionTransportEngine = "cli" | "runtime";
 export type LogicalSessionSource = "xacpx" | "agent-side";
+export interface LogicalSessionOwner {
+    kind: "bot-direct" | "group-member" | "group-controller";
+    bindingId: string;
+}
 export interface NativeSessionCacheEntry {
     session_id: string;
     cwd?: string;
@@ -59,6 +65,7 @@ export interface LogicalSession {
     archived_at?: string;
     created_at: string;
     last_used_at: string;
+    owner?: LogicalSessionOwner;
 }
 export interface BackgroundResult {
     text: string;
@@ -76,5 +83,9 @@ export interface AppState {
     native_session_lists: Record<string, NativeSessionListCacheRecord>;
     orchestration: OrchestrationState;
     scheduled_tasks: Record<string, ScheduledTaskRecord>;
+    bots: Record<string, BotProfile>;
+    conversations: Record<string, ConversationRecord>;
+    conversation_topics: Record<string, ConversationTopic>;
+    bot_runtime_bindings: Record<string, BotRuntimeBinding>;
 }
 export declare function createEmptyState(): AppState;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.24.5-beta.0",
+  "version": "0.24.5",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",