clawconnect-agent 0.1.7 → 0.1.9

package/dist/core/relay/timeline-event-log.d.ts

@@ -0,0 +1,81 @@
+export declare const CANONICAL_TIMELINE_PROTOCOL_VERSION: 2;
+export type TimelineEventType = "turn.user.created" | "message.part.delta" | "message.completed" | "run.completed" | "run.failed" | "run.aborted" | "history.snapshot.page" | "attachment.state.changed" | "tool.invocation.updated";
+export type TimelineRole = "user" | "assistant" | "tool" | "system";
+export type TimelineMessageState = "pending" | "streaming" | "completed" | "failed" | "aborted";
+export type TimelineRunState = "inactive" | "active" | "completed" | "failed" | "aborted";
+export type TimelineSource = "local" | "live" | "history" | "relay-legacy";
+export type AttachmentState = "local_pending" | "uploading" | "uploaded" | "linked" | "available" | "expired" | "failed";
+export type ToolState = "pending_approval" | "approved" | "denied" | "running" | "streaming_output" | "success" | "failed" | "cancelled";
+export type TimelineContentBlock = Record<string, unknown> & {
+    type: string;
+};
+export type TimelineAttachment = Record<string, unknown> & {
+    attachmentId: string;
+    state: AttachmentState;
+};
+export type TimelineError = Record<string, unknown> & {
+    userMessage?: string;
+    code?: string;
+};
+export type CanonicalTimelineEvent = {
+    protocolVersion: 2;
+    eventId: string;
+    eventType: TimelineEventType;
+    gatewayId: string;
+    sessionKey: string;
+    turnId: string;
+    runId: string;
+    messageId: string;
+    partId: string;
+    attachmentId: string | null;
+    seq: number;
+    turnSeq: number;
+    role: TimelineRole;
+    messageState: TimelineMessageState;
+    runState: TimelineRunState;
+    createdAt: string;
+    source: TimelineSource;
+    content: TimelineContentBlock[];
+    attachment: TimelineAttachment | null;
+    error: TimelineError | null;
+    toolInvocationId?: string;
+    toolState?: ToolState;
+    extensions?: Record<string, unknown>;
+};
+export type TimelineHistoryMessage = {
+    turnId: string;
+    messageId: string;
+    role: TimelineRole;
+    messageState: TimelineMessageState;
+    createdAt: string;
+    content: TimelineContentBlock[];
+    partId?: string;
+    runId?: string;
+};
+export type CanonicalTimelineHistorySnapshotPage = {
+    protocolVersion: 2;
+    eventType: "history.snapshot.page";
+    gatewayId: string;
+    sessionKey: string;
+    source: TimelineSource;
+    cursor: string | null;
+    hasMore: boolean;
+    nextCursor: string | null;
+    newestCursor: string | null;
+    messages: TimelineHistoryMessage[];
+    attachments: TimelineAttachment[];
+    extensions?: Record<string, unknown>;
+};
+export declare function parseCanonicalTimelineEvent(input: unknown): CanonicalTimelineEvent;
+export declare function isCanonicalTimelineEvent(input: unknown): input is CanonicalTimelineEvent;
+export declare function parseCanonicalTimelineHistorySnapshotPage(input: unknown): CanonicalTimelineHistorySnapshotPage;
+export declare function createTimelineIdempotencyTracker(): {
+    acceptEvent(input: Pick<CanonicalTimelineEvent, "eventId">): {
+        accepted: boolean;
+        reason?: string;
+    };
+    acceptPartSeq(input: Pick<CanonicalTimelineEvent, "messageId" | "partId" | "seq">): {
+        accepted: boolean;
+        reason?: string;
+    };
+};

package/dist/core/relay/timeline-event-log.js

@@ -0,0 +1,254 @@
+export const CANONICAL_TIMELINE_PROTOCOL_VERSION = 2;
+const eventTypes = new Set([
+    "turn.user.created",
+    "message.part.delta",
+    "message.completed",
+    "run.completed",
+    "run.failed",
+    "run.aborted",
+    "history.snapshot.page",
+    "attachment.state.changed",
+    "tool.invocation.updated",
+]);
+const roles = new Set(["user", "assistant", "tool", "system"]);
+const messageStates = new Set([
+    "pending",
+    "streaming",
+    "completed",
+    "failed",
+    "aborted",
+]);
+const runStates = new Set([
+    "inactive",
+    "active",
+    "completed",
+    "failed",
+    "aborted",
+]);
+const sources = new Set(["local", "live", "history", "relay-legacy"]);
+const canonicalEventFields = new Set([
+    "protocolVersion",
+    "eventId",
+    "eventType",
+    "gatewayId",
+    "sessionKey",
+    "turnId",
+    "runId",
+    "messageId",
+    "partId",
+    "attachmentId",
+    "seq",
+    "turnSeq",
+    "role",
+    "messageState",
+    "runState",
+    "createdAt",
+    "source",
+    "content",
+    "attachment",
+    "error",
+    "toolInvocationId",
+    "toolState",
+]);
+const historyPageFields = new Set([
+    "protocolVersion",
+    "eventType",
+    "gatewayId",
+    "sessionKey",
+    "source",
+    "cursor",
+    "hasMore",
+    "nextCursor",
+    "newestCursor",
+    "messages",
+    "attachments",
+]);
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function requiredString(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`Invalid canonical timeline event: missing ${field}`);
+    }
+    return value;
+}
+function requiredNumber(record, field) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`Invalid canonical timeline event: missing ${field}`);
+    }
+    return value;
+}
+function parseContentBlocks(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("Invalid canonical timeline event: content must be an array");
+    }
+    return value.map((block) => {
+        if (!isRecord(block) || typeof block.type !== "string" || block.type.length === 0) {
+            throw new Error("Invalid canonical timeline event: content block requires type");
+        }
+        return { ...block, type: block.type };
+    });
+}
+function parseNullableRecord(value, field) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        throw new Error(`Invalid canonical timeline event: ${field} must be an object or null`);
+    }
+    return value;
+}
+function collectExtensions(record, knownFields) {
+    const extensions = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (!knownFields.has(key)) {
+            extensions[key] = value;
+        }
+    }
+    return Object.keys(extensions).length > 0 ? extensions : undefined;
+}
+export function parseCanonicalTimelineEvent(input) {
+    if (!isRecord(input)) {
+        throw new Error("Invalid canonical timeline event: expected object");
+    }
+    if (input.protocolVersion !== CANONICAL_TIMELINE_PROTOCOL_VERSION) {
+        throw new Error("Invalid canonical timeline event: protocolVersion must be 2");
+    }
+    const eventType = requiredString(input, "eventType");
+    if (!eventTypes.has(eventType)) {
+        throw new Error(`Invalid canonical timeline event: unsupported eventType ${eventType}`);
+    }
+    const role = requiredString(input, "role");
+    if (!roles.has(role)) {
+        throw new Error(`Invalid canonical timeline event: unsupported role ${role}`);
+    }
+    const messageState = requiredString(input, "messageState");
+    if (!messageStates.has(messageState)) {
+        throw new Error(`Invalid canonical timeline event: unsupported messageState ${messageState}`);
+    }
+    const runState = requiredString(input, "runState");
+    if (!runStates.has(runState)) {
+        throw new Error(`Invalid canonical timeline event: unsupported runState ${runState}`);
+    }
+    const source = requiredString(input, "source");
+    if (!sources.has(source)) {
+        throw new Error(`Invalid canonical timeline event: unsupported source ${source}`);
+    }
+    return {
+        protocolVersion: CANONICAL_TIMELINE_PROTOCOL_VERSION,
+        eventId: requiredString(input, "eventId"),
+        eventType,
+        gatewayId: requiredString(input, "gatewayId"),
+        sessionKey: requiredString(input, "sessionKey"),
+        turnId: requiredString(input, "turnId"),
+        runId: requiredString(input, "runId"),
+        messageId: requiredString(input, "messageId"),
+        partId: requiredString(input, "partId"),
+        attachmentId: input.attachmentId === undefined || input.attachmentId === null
+            ? null
+            : requiredString(input, "attachmentId"),
+        seq: requiredNumber(input, "seq"),
+        turnSeq: requiredNumber(input, "turnSeq"),
+        role,
+        messageState,
+        runState,
+        createdAt: requiredString(input, "createdAt"),
+        source,
+        content: parseContentBlocks(input.content),
+        attachment: parseNullableRecord(input.attachment, "attachment"),
+        error: parseNullableRecord(input.error, "error"),
+        ...(typeof input.toolInvocationId === "string" ? { toolInvocationId: input.toolInvocationId } : {}),
+        ...(typeof input.toolState === "string" ? { toolState: input.toolState } : {}),
+        ...(collectExtensions(input, canonicalEventFields)
+            ? { extensions: collectExtensions(input, canonicalEventFields) }
+            : {}),
+    };
+}
+export function isCanonicalTimelineEvent(input) {
+    try {
+        parseCanonicalTimelineEvent(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseHistoryMessage(input) {
+    if (!isRecord(input)) {
+        throw new Error("Invalid canonical history snapshot page: message must be an object");
+    }
+    const role = requiredString(input, "role");
+    const messageState = requiredString(input, "messageState");
+    if (!roles.has(role) || !messageStates.has(messageState)) {
+        throw new Error("Invalid canonical history snapshot page: invalid message role/state");
+    }
+    return {
+        turnId: requiredString(input, "turnId"),
+        messageId: requiredString(input, "messageId"),
+        role,
+        messageState,
+        createdAt: requiredString(input, "createdAt"),
+        content: parseContentBlocks(input.content),
+        ...(typeof input.partId === "string" ? { partId: input.partId } : {}),
+        ...(typeof input.runId === "string" ? { runId: input.runId } : {}),
+    };
+}
+export function parseCanonicalTimelineHistorySnapshotPage(input) {
+    if (!isRecord(input)) {
+        throw new Error("Invalid canonical history snapshot page: expected object");
+    }
+    if (input.protocolVersion !== CANONICAL_TIMELINE_PROTOCOL_VERSION) {
+        throw new Error("Invalid canonical history snapshot page: protocolVersion must be 2");
+    }
+    if (input.eventType !== "history.snapshot.page") {
+        throw new Error("Invalid canonical history snapshot page: eventType must be history.snapshot.page");
+    }
+    const source = requiredString(input, "source");
+    if (!sources.has(source)) {
+        throw new Error(`Invalid canonical history snapshot page: unsupported source ${source}`);
+    }
+    if (!Array.isArray(input.messages)) {
+        throw new Error("Invalid canonical history snapshot page: messages must be an array");
+    }
+    const attachments = Array.isArray(input.attachments) ? input.attachments : [];
+    return {
+        protocolVersion: CANONICAL_TIMELINE_PROTOCOL_VERSION,
+        eventType: "history.snapshot.page",
+        gatewayId: requiredString(input, "gatewayId"),
+        sessionKey: requiredString(input, "sessionKey"),
+        source,
+        cursor: typeof input.cursor === "string" ? input.cursor : null,
+        hasMore: Boolean(input.hasMore),
+        nextCursor: typeof input.nextCursor === "string" ? input.nextCursor : null,
+        newestCursor: typeof input.newestCursor === "string" ? input.newestCursor : null,
+        messages: input.messages.map(parseHistoryMessage),
+        attachments: attachments.filter(isRecord),
+        ...(collectExtensions(input, historyPageFields)
+            ? { extensions: collectExtensions(input, historyPageFields) }
+            : {}),
+    };
+}
+export function createTimelineIdempotencyTracker() {
+    const eventIds = new Set();
+    const partSeqKeys = new Set();
+    return {
+        acceptEvent(input) {
+            if (eventIds.has(input.eventId)) {
+                return { accepted: false, reason: "duplicate_event_id" };
+            }
+            eventIds.add(input.eventId);
+            return { accepted: true };
+        },
+        acceptPartSeq(input) {
+            const key = `${input.messageId}\u0000${input.partId}\u0000${input.seq}`;
+            if (partSeqKeys.has(key)) {
+                return { accepted: false, reason: "duplicate_part_seq" };
+            }
+            partSeqKeys.add(key);
+            return { accepted: true };
+        },
+    };
+}
+//# sourceMappingURL=timeline-event-log.js.map

package/dist/core/relay/timeline-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-event-log.js","sourceRoot":"","sources":["../../../src/core/relay/timeline-event-log.ts"],"names":[],"mappings":"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"}

package/dist/{relay → core/relay}/voice-input.js

@@ -16,7 +16,7 @@ export async function prepareVoiceSendParams(rawParams, options = {}) {
     if (!audio.mimeType.toLowerCase().startsWith("audio/")) {
         throw new Error("voice_audio_required");
     }
-    const languageHint = stringValue(record.languageHint);
+    const languageHint = stringValue(record.languageHint) ?? stringValue(record.language);
     const stagingRoot = options.stagingDir ?? await mkdtemp(join(tmpdir(), "clawconnect-voice-input-"));
     await mkdir(stagingRoot, { recursive: true });
     const audioPath = join(stagingRoot, resolveVoiceAudioFileName(audio));
@@ -38,6 +38,7 @@ export async function prepareVoiceSendParams(rawParams, options = {}) {
     };
     delete next.audio;
     delete next.languageHint;
+    delete next.language;
     delete next.attachments;
     return next;
 }
@@ -49,11 +50,12 @@ export function voiceInputSetupMessage(error) {
     return [
         "未安装语音输入技能，暂时不能使用语音对话。",
         "安装路径：ClawLink → 技能扩展 → 语音转文字（SenseVoice int8）→ 安装。",
-        "安装完成后会写入 OPENCLAW_ASR_COMMAND，然后重启 ClawConnect 再试。",
+        "安装完成后会写入 CLAWCONNECT_ASR_COMMAND；旧版 OPENCLAW_ASR_COMMAND 仍兼容。然后重启 ClawConnect 再试。",
     ].join("\n");
 }
 async function transcribeAudioWithConfiguredCommand(opts) {
-    const command = process.env.OPENCLAW_ASR_COMMAND?.trim();
+    const command = process.env.CLAWCONNECT_ASR_COMMAND?.trim()
+        || process.env.OPENCLAW_ASR_COMMAND?.trim();
     if (!command) {
         throw new Error("voice_asr_not_configured");
     }

package/dist/core/relay/voice-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-input.js","sourceRoot":"","sources":["../../../src/core/relay/voice-input.ts"],"names":[],"mappings":"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"}

package/dist/hermes/hermes-relay-manager.d.ts

@@ -1,5 +1,10 @@
-import type { SendFileCommandOptions } from "../commands/send-file.js";
-import type { RelaySlashCommandDescriptor } from "../relay/slash-command-catalog.js";
+import { type FileUploadRequest } from "../core/relay/file-upload.js";
+import type { RelaySlashCommandDescriptor } from "../core/relay/slash-command-types.js";
+import { type MobileChatRun } from "../core/relay/mobile-chat-run-bridge.js";
+export type ActiveHermesChatRun = {
+    controller: AbortController;
+    run: MobileChatRun;
+};
 export type HermesRelayHelloMessage = {
     type: "hello";
     platform: string;
@@ -38,12 +43,17 @@ export declare function buildHermesRelayHelloMessage(opts: {
     capabilities?: string[];
     slashCommands?: readonly RelaySlashCommandDescriptor[];
 }): HermesRelayHelloMessage;
+export declare function rememberActiveHermesChatRun(activeChatRuns: Map<string, ActiveHermesChatRun>, run: MobileChatRun, params: unknown, requestId: string | undefined, controller: AbortController): void;
+export declare function resolveHermesAbortRun(params: unknown, activeChatRuns: Map<string, ActiveHermesChatRun>): ActiveHermesChatRun | undefined;
+export declare function resolveHermesChatPreferredRunId(params: unknown, voiceInputRun?: MobileChatRun): string | undefined;
 export declare function runHermesRelayManager(opts: HermesRelayManagerOptions): Promise<boolean>;
-export declare function buildHermesArtifactSendOptions(params: {
+export declare function buildHermesArtifactUploadRequest(params: {
     artifactPath: string;
+    relayServerUrl: string;
+    relaySecret: string;
     gatewayId: string;
     sessionKey: string;
     runId: string;
-}): SendFileCommandOptions;
+}): FileUploadRequest;
 export declare function shouldPublishHermesOfficeSnapshot(eventName: string | undefined, payload: unknown): boolean;
 export {};