@zhin.js/adapter-sandbox 7.0.11 → 7.0.15

package/pages/playgroundState.js

@@ -0,0 +1,126 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { DEFAULT_SANDBOX_AGENT_RUN_CONFIG, normalizeSandboxAgentRunConfig, } from "../lib/run-config.js";
+export const PLAYGROUND_STORAGE_KEY = 'zhin.sandbox.agent-playground.v1';
+export function createDefaultPlaygroundState(workingDirectory = '') {
+    const runConfig = (safetyMode) => ({
+        ...DEFAULT_SANDBOX_AGENT_RUN_CONFIG,
+        workingDirectory,
+        safetyMode,
+    });
+    const sessions = [
+        { id: 'sandbox-user', name: '快速试验', type: 'private', unread: 0, runConfig: runConfig('workspace-write') },
+        { id: 'sandbox-group', name: '群组作用域', type: 'group', unread: 0, runConfig: runConfig('workspace-write') },
+        { id: 'sandbox-channel', name: '频道作用域', type: 'channel', unread: 0, runConfig: runConfig('read-only') },
+    ];
+    return Object.freeze({
+        version: 1,
+        activeSessionId: sessions[0].id,
+        activeSessionType: sessions[0].type,
+        sessions,
+        messages: [],
+    });
+}
+export function loadPlaygroundState(storage = browserStorage()) {
+    const fallback = createDefaultPlaygroundState();
+    if (!storage)
+        return fallback;
+    try {
+        const raw = storage.getItem(PLAYGROUND_STORAGE_KEY);
+        if (!raw)
+            return fallback;
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1)
+            return fallback;
+        const sessions = Array.isArray(parsed.sessions)
+            ? parsed.sessions.map(parseSession).filter((item) => Boolean(item))
+            : [];
+        if (sessions.length === 0)
+            return fallback;
+        const sessionKeys = new Set(sessions.map(sessionIdentity));
+        const messages = Array.isArray(parsed.messages)
+            ? parsed.messages.map(parseMessage).filter((item) => (Boolean(item) && sessionKeys.has(sessionIdentity({ id: item.channelId, type: item.channelType }))))
+            : [];
+        const requestedActive = typeof parsed.activeSessionId === 'string'
+            ? sessions.find((session) => session.id === parsed.activeSessionId && (parsed.activeSessionType === undefined || session.type === parsed.activeSessionType))
+            : undefined;
+        const activeSession = requestedActive ?? sessions[0];
+        return Object.freeze({
+            version: 1,
+            activeSessionId: activeSession.id,
+            activeSessionType: activeSession.type,
+            sessions,
+            messages,
+        });
+    }
+    catch {
+        return fallback;
+    }
+}
+export function savePlaygroundState(state, storage = browserStorage()) {
+    if (!storage)
+        return false;
+    try {
+        const sessions = state.sessions;
+        const sessionKeys = new Set(sessions.map(sessionIdentity));
+        const activeSession = sessions.find((session) => session.id === state.activeSessionId && (state.activeSessionType === undefined || session.type === state.activeSessionType)) ?? sessions[0];
+        storage.setItem(PLAYGROUND_STORAGE_KEY, JSON.stringify({
+            version: 1,
+            activeSessionId: activeSession?.id ?? '',
+            activeSessionType: activeSession?.type,
+            sessions,
+            messages: state.messages.filter((message) => sessionKeys.has(sessionIdentity({
+                id: message.channelId,
+                type: message.channelType,
+            }))),
+        }));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseSession(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const item = value;
+    if (typeof item.id !== 'string' || !item.id.trim() || typeof item.name !== 'string')
+        return undefined;
+    if (item.type !== 'private' && item.type !== 'group' && item.type !== 'channel')
+        return undefined;
+    return {
+        id: item.id.slice(0, 256),
+        name: item.name.trim().slice(0, 120) || '未命名试验',
+        type: item.type,
+        unread: Number.isSafeInteger(item.unread) && Number(item.unread) > 0 ? Number(item.unread) : 0,
+        runConfig: normalizeSandboxAgentRunConfig(item.runConfig) ?? DEFAULT_SANDBOX_AGENT_RUN_CONFIG,
+    };
+}
+function parseMessage(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const item = value;
+    if (typeof item.id !== 'string' || typeof item.channelId !== 'string' || !Array.isArray(item.content))
+        return undefined;
+    if (item.type !== 'sent' && item.type !== 'received')
+        return undefined;
+    if (item.channelType !== 'private' && item.channelType !== 'group' && item.channelType !== 'channel')
+        return undefined;
+    return {
+        id: item.id.slice(0, 256),
+        type: item.type,
+        channelType: item.channelType,
+        channelId: item.channelId.slice(0, 256),
+        channelName: typeof item.channelName === 'string' ? item.channelName.slice(0, 120) : '',
+        senderId: typeof item.senderId === 'string' ? item.senderId.slice(0, 256) : '',
+        senderName: typeof item.senderName === 'string' ? item.senderName.slice(0, 120) : '',
+        content: item.content,
+        timestamp: Number.isFinite(item.timestamp) ? Number(item.timestamp) : Date.now(),
+        ...(item.interactionResolved === true ? { interactionResolved: true } : {}),
+    };
+}
+function browserStorage() {
+    return typeof window === 'undefined' ? undefined : window.localStorage;
+}
+function sessionIdentity(value) {
+    return `${value.type}\0${value.id}`;
+}

package/pages/playgroundState.test.js

@@ -0,0 +1,92 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { PLAYGROUND_STORAGE_KEY, createDefaultPlaygroundState, loadPlaygroundState, savePlaygroundState, } from './playgroundState.js';
+class MemoryStorage {
+    values = new Map();
+    getItem(key) { return this.values.get(key) ?? null; }
+    setItem(key, value) { this.values.set(key, value); }
+}
+describe('sandbox playground persistence', () => {
+    it('round-trips sessions, messages and per-session run configuration', () => {
+        const storage = new MemoryStorage();
+        const initial = createDefaultPlaygroundState('/workspace/zhin');
+        const sessions = initial.sessions.map((session, index) => index === 0
+            ? { ...session, runConfig: { ...session.runConfig, safetyMode: 'read-only', networkAccess: true } }
+            : session);
+        expect(savePlaygroundState({
+            activeSessionId: sessions[0].id,
+            sessions,
+            messages: [{
+                    id: 'm1', type: 'sent', channelType: 'private', channelId: sessions[0].id,
+                    channelName: sessions[0].name, senderId: 'owner', senderName: 'Owner',
+                    content: [{ type: 'text', data: { text: 'hello' } }], timestamp: 42,
+                    interactionResolved: true,
+                }],
+        }, storage)).toBe(true);
+        const restored = loadPlaygroundState(storage);
+        expect(restored.activeSessionId).toBe('sandbox-user');
+        expect(restored.sessions[0]?.runConfig).toMatchObject({
+            workingDirectory: '/workspace/zhin', safetyMode: 'read-only', networkAccess: true,
+        });
+        expect(restored.messages[0]).toMatchObject({ id: 'm1', channelId: 'sandbox-user', interactionResolved: true });
+    });
+    it('fails closed to defaults for malformed storage', () => {
+        const storage = new MemoryStorage();
+        storage.values.set(PLAYGROUND_STORAGE_KEY, '{broken');
+        expect(loadPlaygroundState(storage).sessions.map((session) => session.id)).toEqual([
+            'sandbox-user', 'sandbox-group', 'sandbox-channel',
+        ]);
+    });
+    it('does not silently accept an unknown persisted schema version', () => {
+        const storage = new MemoryStorage();
+        storage.values.set(PLAYGROUND_STORAGE_KEY, JSON.stringify({ version: 2, sessions: [] }));
+        expect(loadPlaygroundState(storage).activeSessionId).toBe('sandbox-user');
+    });
+    it('keeps complete message history instead of silently trimming old entries', () => {
+        const storage = new MemoryStorage();
+        const initial = createDefaultPlaygroundState('/workspace/zhin');
+        const messages = Array.from({ length: 240 }, (_, index) => ({
+            id: `m${index}`,
+            type: 'sent',
+            channelType: 'private',
+            channelId: initial.sessions[0].id,
+            channelName: initial.sessions[0].name,
+            senderId: 'owner',
+            senderName: 'Owner',
+            content: [{ type: 'text', data: { text: `message ${index}` } }],
+            timestamp: index,
+        }));
+        expect(savePlaygroundState({
+            activeSessionId: initial.activeSessionId,
+            sessions: initial.sessions,
+            messages,
+        }, storage)).toBe(true);
+        expect(loadPlaygroundState(storage).messages).toHaveLength(240);
+    });
+    it('keeps sessions with the same id isolated by scope', () => {
+        const storage = new MemoryStorage();
+        const initial = createDefaultPlaygroundState('/workspace/zhin');
+        const sessions = [
+            { ...initial.sessions[0], id: 'shared', type: 'private' },
+            { ...initial.sessions[1], id: 'shared', type: 'group' },
+        ];
+        expect(savePlaygroundState({
+            activeSessionId: 'shared',
+            activeSessionType: 'group',
+            sessions,
+            messages: sessions.map((session, index) => ({
+                id: `m${index}`,
+                type: 'sent',
+                channelType: session.type,
+                channelId: session.id,
+                channelName: session.name,
+                senderId: 'owner',
+                senderName: 'Owner',
+                content: [{ type: 'text', data: { text: session.type } }],
+                timestamp: index,
+            })),
+        }, storage)).toBe(true);
+        const restored = loadPlaygroundState(storage);
+        expect(restored.activeSessionType).toBe('group');
+        expect(restored.messages.map((message) => message.channelType)).toEqual(['private', 'group']);
+    });
+});

package/pages/playgroundState.test.ts

@@ -0,0 +1,105 @@
+import {
+  PLAYGROUND_STORAGE_KEY,
+  createDefaultPlaygroundState,
+  loadPlaygroundState,
+  savePlaygroundState,
+  type PlaygroundStorage,
+} from './playgroundState.js';
+
+class MemoryStorage implements PlaygroundStorage {
+  readonly values = new Map<string, string>();
+  getItem(key: string): string | null { return this.values.get(key) ?? null; }
+  setItem(key: string, value: string): void { this.values.set(key, value); }
+}
+
+describe('sandbox playground persistence', () => {
+  it('round-trips sessions, messages and per-session run configuration', () => {
+    const storage = new MemoryStorage();
+    const initial = createDefaultPlaygroundState('/workspace/zhin');
+    const sessions = initial.sessions.map((session, index) => index === 0
+      ? { ...session, runConfig: { ...session.runConfig, safetyMode: 'read-only' as const, networkAccess: true } }
+      : session);
+    expect(savePlaygroundState({
+      activeSessionId: sessions[0]!.id,
+      sessions,
+      messages: [{
+        id: 'm1', type: 'sent', channelType: 'private', channelId: sessions[0]!.id,
+        channelName: sessions[0]!.name, senderId: 'owner', senderName: 'Owner',
+        content: [{ type: 'text', data: { text: 'hello' } }], timestamp: 42,
+        interactionResolved: true,
+      }],
+    }, storage)).toBe(true);
+
+    const restored = loadPlaygroundState(storage);
+    expect(restored.activeSessionId).toBe('sandbox-user');
+    expect(restored.sessions[0]?.runConfig).toMatchObject({
+      workingDirectory: '/workspace/zhin', safetyMode: 'read-only', networkAccess: true,
+    });
+    expect(restored.messages[0]).toMatchObject({ id: 'm1', channelId: 'sandbox-user', interactionResolved: true });
+  });
+
+  it('fails closed to defaults for malformed storage', () => {
+    const storage = new MemoryStorage();
+    storage.values.set(PLAYGROUND_STORAGE_KEY, '{broken');
+    expect(loadPlaygroundState(storage).sessions.map((session) => session.id)).toEqual([
+      'sandbox-user', 'sandbox-group', 'sandbox-channel',
+    ]);
+  });
+
+  it('does not silently accept an unknown persisted schema version', () => {
+    const storage = new MemoryStorage();
+    storage.values.set(PLAYGROUND_STORAGE_KEY, JSON.stringify({ version: 2, sessions: [] }));
+    expect(loadPlaygroundState(storage).activeSessionId).toBe('sandbox-user');
+  });
+
+  it('keeps complete message history instead of silently trimming old entries', () => {
+    const storage = new MemoryStorage();
+    const initial = createDefaultPlaygroundState('/workspace/zhin');
+    const messages = Array.from({ length: 240 }, (_, index) => ({
+      id: `m${index}`,
+      type: 'sent' as const,
+      channelType: 'private' as const,
+      channelId: initial.sessions[0]!.id,
+      channelName: initial.sessions[0]!.name,
+      senderId: 'owner',
+      senderName: 'Owner',
+      content: [{ type: 'text', data: { text: `message ${index}` } }],
+      timestamp: index,
+    }));
+    expect(savePlaygroundState({
+      activeSessionId: initial.activeSessionId,
+      sessions: initial.sessions,
+      messages,
+    }, storage)).toBe(true);
+    expect(loadPlaygroundState(storage).messages).toHaveLength(240);
+  });
+
+  it('keeps sessions with the same id isolated by scope', () => {
+    const storage = new MemoryStorage();
+    const initial = createDefaultPlaygroundState('/workspace/zhin');
+    const sessions = [
+      { ...initial.sessions[0]!, id: 'shared', type: 'private' as const },
+      { ...initial.sessions[1]!, id: 'shared', type: 'group' as const },
+    ];
+    expect(savePlaygroundState({
+      activeSessionId: 'shared',
+      activeSessionType: 'group',
+      sessions,
+      messages: sessions.map((session, index) => ({
+        id: `m${index}`,
+        type: 'sent' as const,
+        channelType: session.type,
+        channelId: session.id,
+        channelName: session.name,
+        senderId: 'owner',
+        senderName: 'Owner',
+        content: [{ type: 'text', data: { text: session.type } }],
+        timestamp: index,
+      })),
+    }, storage)).toBe(true);
+
+    const restored = loadPlaygroundState(storage);
+    expect(restored.activeSessionType).toBe('group');
+    expect(restored.messages.map((message) => message.channelType)).toEqual(['private', 'group']);
+  });
+});

package/pages/playgroundState.ts

@@ -0,0 +1,172 @@
+import type { MessageSegment } from '@zhin.js/client';
+import {
+  DEFAULT_SANDBOX_AGENT_RUN_CONFIG,
+  normalizeSandboxAgentRunConfig,
+  type SandboxAgentRunConfig,
+  type SandboxSafetyMode,
+} from '../src/run-config.js';
+
+export const PLAYGROUND_STORAGE_KEY = 'zhin.sandbox.agent-playground.v1';
+
+export type PlaygroundScope = 'private' | 'group' | 'channel';
+
+export interface PlaygroundSession {
+  readonly id: string;
+  readonly name: string;
+  readonly type: PlaygroundScope;
+  readonly unread: number;
+  readonly runConfig: SandboxAgentRunConfig;
+}
+
+export interface PlaygroundMessage {
+  readonly id: string;
+  readonly type: 'sent' | 'received';
+  readonly channelType: PlaygroundScope;
+  readonly channelId: string;
+  readonly channelName: string;
+  readonly senderId: string;
+  readonly senderName: string;
+  readonly content: MessageSegment[];
+  readonly timestamp: number;
+  readonly interactionResolved?: boolean;
+}
+
+export interface PlaygroundState {
+  readonly version: 1;
+  readonly activeSessionId: string;
+  readonly activeSessionType?: PlaygroundScope;
+  readonly sessions: readonly PlaygroundSession[];
+  readonly messages: readonly PlaygroundMessage[];
+}
+
+export interface PlaygroundStorage {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+}
+
+export function createDefaultPlaygroundState(workingDirectory = ''): PlaygroundState {
+  const runConfig = (safetyMode: SandboxSafetyMode): SandboxAgentRunConfig => ({
+    ...DEFAULT_SANDBOX_AGENT_RUN_CONFIG,
+    workingDirectory,
+    safetyMode,
+  });
+  const sessions: PlaygroundSession[] = [
+    { id: 'sandbox-user', name: '快速试验', type: 'private', unread: 0, runConfig: runConfig('workspace-write') },
+    { id: 'sandbox-group', name: '群组作用域', type: 'group', unread: 0, runConfig: runConfig('workspace-write') },
+    { id: 'sandbox-channel', name: '频道作用域', type: 'channel', unread: 0, runConfig: runConfig('read-only') },
+  ];
+  return Object.freeze({
+    version: 1,
+    activeSessionId: sessions[0]!.id,
+    activeSessionType: sessions[0]!.type,
+    sessions,
+    messages: [],
+  });
+}
+
+export function loadPlaygroundState(
+  storage: PlaygroundStorage | undefined = browserStorage(),
+): PlaygroundState {
+  const fallback = createDefaultPlaygroundState();
+  if (!storage) return fallback;
+  try {
+    const raw = storage.getItem(PLAYGROUND_STORAGE_KEY);
+    if (!raw) return fallback;
+    const parsed = JSON.parse(raw) as Record<string, unknown>;
+    if (parsed.version !== 1) return fallback;
+    const sessions = Array.isArray(parsed.sessions)
+      ? parsed.sessions.map(parseSession).filter((item): item is PlaygroundSession => Boolean(item))
+      : [];
+    if (sessions.length === 0) return fallback;
+    const sessionKeys = new Set(sessions.map(sessionIdentity));
+    const messages = Array.isArray(parsed.messages)
+      ? parsed.messages.map(parseMessage).filter((item): item is PlaygroundMessage => (
+          Boolean(item) && sessionKeys.has(sessionIdentity({ id: item.channelId, type: item.channelType }))
+        ))
+      : [];
+    const requestedActive = typeof parsed.activeSessionId === 'string'
+      ? sessions.find((session) => session.id === parsed.activeSessionId && (
+          parsed.activeSessionType === undefined || session.type === parsed.activeSessionType
+        ))
+      : undefined;
+    const activeSession = requestedActive ?? sessions[0]!;
+    return Object.freeze({
+      version: 1,
+      activeSessionId: activeSession.id,
+      activeSessionType: activeSession.type,
+      sessions,
+      messages,
+    });
+  } catch {
+    return fallback;
+  }
+}
+
+export function savePlaygroundState(
+  state: Omit<PlaygroundState, 'version'>,
+  storage: PlaygroundStorage | undefined = browserStorage(),
+): boolean {
+  if (!storage) return false;
+  try {
+    const sessions = state.sessions;
+    const sessionKeys = new Set(sessions.map(sessionIdentity));
+    const activeSession = sessions.find((session) => session.id === state.activeSessionId && (
+      state.activeSessionType === undefined || session.type === state.activeSessionType
+    )) ?? sessions[0];
+    storage.setItem(PLAYGROUND_STORAGE_KEY, JSON.stringify({
+      version: 1,
+      activeSessionId: activeSession?.id ?? '',
+      activeSessionType: activeSession?.type,
+      sessions,
+      messages: state.messages.filter((message) => sessionKeys.has(sessionIdentity({
+        id: message.channelId,
+        type: message.channelType,
+      }))),
+    } satisfies PlaygroundState));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function parseSession(value: unknown): PlaygroundSession | undefined {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;
+  const item = value as Record<string, unknown>;
+  if (typeof item.id !== 'string' || !item.id.trim() || typeof item.name !== 'string') return undefined;
+  if (item.type !== 'private' && item.type !== 'group' && item.type !== 'channel') return undefined;
+  return {
+    id: item.id.slice(0, 256),
+    name: item.name.trim().slice(0, 120) || '未命名试验',
+    type: item.type,
+    unread: Number.isSafeInteger(item.unread) && Number(item.unread) > 0 ? Number(item.unread) : 0,
+    runConfig: normalizeSandboxAgentRunConfig(item.runConfig) ?? DEFAULT_SANDBOX_AGENT_RUN_CONFIG,
+  };
+}
+
+function parseMessage(value: unknown): PlaygroundMessage | undefined {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;
+  const item = value as Record<string, unknown>;
+  if (typeof item.id !== 'string' || typeof item.channelId !== 'string' || !Array.isArray(item.content)) return undefined;
+  if (item.type !== 'sent' && item.type !== 'received') return undefined;
+  if (item.channelType !== 'private' && item.channelType !== 'group' && item.channelType !== 'channel') return undefined;
+  return {
+    id: item.id.slice(0, 256),
+    type: item.type,
+    channelType: item.channelType,
+    channelId: item.channelId.slice(0, 256),
+    channelName: typeof item.channelName === 'string' ? item.channelName.slice(0, 120) : '',
+    senderId: typeof item.senderId === 'string' ? item.senderId.slice(0, 256) : '',
+    senderName: typeof item.senderName === 'string' ? item.senderName.slice(0, 120) : '',
+    content: item.content as MessageSegment[],
+    timestamp: Number.isFinite(item.timestamp) ? Number(item.timestamp) : Date.now(),
+    ...(item.interactionResolved === true ? { interactionResolved: true } : {}),
+  };
+}
+
+function browserStorage(): PlaygroundStorage | undefined {
+  return typeof window === 'undefined' ? undefined : window.localStorage;
+}
+
+function sessionIdentity(value: Pick<PlaygroundSession, 'id' | 'type'>): string {
+  return `${value.type}\0${value.id}`;
+}