@tencent-ai/codebuddy-code 2.100.1 → 2.101.0

package/vendor/sandbox/SandboxExt.xcframework/macos-arm64_x86_64/SandboxExt.framework/Versions/A/Headers/SandboxExt.h

@@ -0,0 +1,34 @@
+// SandboxExt.h — SandboxExt.framework 的 umbrella header
+//
+// 业务方接入说明：
+//   Swift 业务代码只需 `import SandboxExt` 即可使用 SDK 的全部 Swift API；
+//   暴露给 Swift 的 C 符号（xlog 日志引擎 / projfs 数据结构 / FileProvider API）
+//   通过本 umbrella header 自动并入模块，无需 Bridging Header 或额外 import。
+//
+// C 调用方（Electron / C / C++ 代码）可通过 dlopen/dlsym 动态链接 SandboxExt.framework
+// 并调用导出的 C 符号，例如：
+//   
+//   handle = dlopen("path/to/SandboxExt.framework/SandboxExt", RTLD_NOW);
+//   preregister = dlsym(handle, "fileprovider_preregister_domain");
+//   (*preregister)(0);  // 30s default timeout
+
+#ifndef SANDBOX_EXT_UMBRELLA_H
+#define SANDBOX_EXT_UMBRELLA_H
+
+#ifdef __OBJC__
+#import <Foundation/Foundation.h>
+#endif
+
+// xlog 日志引擎 C API（供 SandboxExt 内部 XLog.swift 与外部业务方使用）
+#import <SandboxExt/xlog_bridge.h>
+
+// projfs FFI 数据结构（FileProvider Extension 实现使用，对外暴露便于业务方扩展）
+#import <SandboxExt/projfs_types.h>
+
+// FileProvider domain registration & management C API（供 Electron 主进程及其他 C 调用方使用）
+#import <SandboxExt/fileprovider_bridge.h>
+
+FOUNDATION_EXPORT double SandboxExtVersionNumber;
+FOUNDATION_EXPORT const unsigned char SandboxExtVersionString[];
+
+#endif /* SANDBOX_EXT_UMBRELLA_H */

package/vendor/sandbox/SandboxExt.xcframework/macos-arm64_x86_64/SandboxExt.framework/Versions/A/Headers/fileprovider_bridge.h

@@ -0,0 +1,125 @@
+// fileprovider_bridge.h — SandboxExt FileProvider C API
+//
+// C-callable interface for FileProvider domain registration and management.
+// Enables Electron and other C callers to register FileProvider domains
+// without Swift language bindings, using dlopen/dlsym dynamic linking.
+//
+// All async operations are bridged to sync C contexts with configurable timeouts.
+// Typical operations complete in <5 seconds; default timeout is 30 seconds.
+//
+// Error reporting:
+//   - Return value: true = success, false = failure
+//   - On failure: call fileprovider_last_error() to get detailed error message
+//   - Error strings are UTF-8, valid until next FFI call on same thread
+//
+// Thread safety:
+//   - Each thread has its own error string storage
+//   - Error strings from one thread don't affect other threads
+//   - FFI functions dispatch to main thread if needed for async operations
+
+#ifndef FILEPROVIDER_BRIDGE_H
+#define FILEPROVIDER_BRIDGE_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// ---------------------------------------------------------------------------
+// Error handling
+// ---------------------------------------------------------------------------
+
+/// Get the most recent error message from a FileProvider operation.
+/// Returns a pointer to a null-terminated UTF-8 string, or NULL if no error.
+/// Pointer remains valid until the next FFI call on this thread.
+/// 
+/// Example usage:
+///   if (!fileprovider_preregister_domain(0)) {
+///       fprintf(stderr, "Error: %s\n", fileprovider_last_error());
+///   }
+const char* fileprovider_last_error(void);
+
+// ---------------------------------------------------------------------------
+// Domain registration
+// ---------------------------------------------------------------------------
+
+/// Pre-register FileProvider domain group 0 (if not already registered).
+/// 
+/// Makes the FileProvider extension visible in macOS system settings,
+/// allowing the user to enable/disable it. Safe to call multiple times.
+/// If domain is already registered, this returns success without re-registering.
+///
+/// Timeout handling:
+///   - timeoutMs = 0: use default 30000ms (30 seconds)
+///   - timeoutMs > 0: use specified timeout in milliseconds
+/// 
+/// Return value:
+///   - true: domain pre-registered successfully or already exists
+///   - false: pre-registration failed; call fileprovider_last_error() for details
+///
+/// Example usage:
+///   bool ok = fileprovider_preregister_domain(0);  // 30s timeout
+///   if (!ok) {
+///       fprintf(stderr, "Domain registration failed: %s\n", 
+///               fileprovider_last_error());
+///   }
+bool fileprovider_preregister_domain(uint32_t timeoutMs);
+
+// ---------------------------------------------------------------------------
+// Extension status
+// ---------------------------------------------------------------------------
+
+/// Check if FileProvider extension is enabled in system settings.
+/// 
+/// Timeout handling: same as fileprovider_preregister_domain()
+/// 
+/// Parameters:
+///   - timeoutMs: operation timeout (0 = default 30000ms)
+///   - outEnabled: pointer to bool where result is stored
+///                 can be NULL to ignore result (fire-and-forget check)
+/// 
+/// Return value:
+///   - true: check succeeded; if outEnabled != NULL, it contains result
+///   - false: check failed; call fileprovider_last_error() for details
+///
+/// Note: Returns true if unable to determine (e.g., no domains exist yet).
+///
+/// Example usage:
+///   bool enabled = false;
+///   if (fileprovider_is_extension_enabled(0, &enabled)) {
+///       printf("Extension enabled: %s\n", enabled ? "yes" : "no");
+///   } else {
+///       fprintf(stderr, "Check failed: %s\n", fileprovider_last_error());
+///   }
+bool fileprovider_is_extension_enabled(uint32_t timeoutMs, bool* outEnabled);
+
+// ---------------------------------------------------------------------------
+// Maintenance
+// ---------------------------------------------------------------------------
+
+/// Clean up legacy FileProvider domains from previous versions.
+///
+/// Removes domains with old prefix strings (e.g., "sandbox-sb-*", "workbuddy-sdb-*")
+/// that are no longer used by current application version. Safe to call even if
+/// no legacy domains exist.
+///
+/// Timeout handling: same as fileprovider_preregister_domain()
+///
+/// Return value:
+///   - true: cleanup succeeded (or no legacy domains found)
+///   - false: cleanup failed; call fileprovider_last_error() for details
+///
+/// Example usage:
+///   if (!fileprovider_cleanup_legacy_domains(0)) {
+///       fprintf(stderr, "Legacy cleanup failed: %s\n", 
+///               fileprovider_last_error());
+///   }
+bool fileprovider_cleanup_legacy_domains(uint32_t timeoutMs);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // FILEPROVIDER_BRIDGE_H

package/vendor/sandbox/SandboxExt.xcframework/macos-arm64_x86_64/SandboxExt.framework/Versions/A/Headers/projfs_types.h

@@ -0,0 +1,34 @@
+// 对应 Rust projfs/ffi.rs 中的 #[repr(C)] 结构体定义
+// 通过 bridging header 导入 Swift，使其可用于 @convention(c) 函数指针
+
+#ifndef projfs_types_h
+#define projfs_types_h
+
+#include <stdint.h>
+#include <stddef.h>
+#include <stdbool.h>
+
+typedef struct {
+    const char *name;
+    const char *relative_path;
+    bool is_directory;
+    int64_t size;
+    double mod_date;
+} ProjfsItemMeta;
+
+typedef struct {
+    ProjfsItemMeta *items;
+    long count;
+} ProjfsItemList;
+
+typedef struct {
+    const char *relative_path;
+    int32_t change_type;
+} ProjfsChangeRecord;
+
+typedef struct {
+    ProjfsChangeRecord *items;
+    long count;
+} ProjfsChangeList;
+
+#endif /* projfs_types_h */

package/vendor/sandbox/SandboxExt.xcframework/macos-arm64_x86_64/SandboxExt.framework/Versions/A/Headers/xlog_bridge.h

@@ -0,0 +1,106 @@
+// xlog_bridge.h — WorkBuddy xlog C bridge
+//
+// 轻量级高性能日志引擎，灵感来自腾讯 mars/xlog，提供：
+//   - mmap 缓冲写入（进程异常退出不丢日志）
+//   - zlib 压缩（减少磁盘占用）
+//   - 异步写入（不阻塞业务线程）
+//   - 日志轮转（按大小 + 按天自动切分，自动清理过期文件）
+//
+// 本文件仅暴露纯 C 接口，供 Rust FFI 调用。
+
+#ifndef WB_XLOG_BRIDGE_H
+#define WB_XLOG_BRIDGE_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// ---------------------------------------------------------------------------
+// 日志级别（与 Rust Level enum 对应）
+// ---------------------------------------------------------------------------
+
+enum WbXlogLevel {
+    WB_XLOG_LEVEL_ERROR = 0,
+    WB_XLOG_LEVEL_WARN  = 1,
+    WB_XLOG_LEVEL_INFO  = 2,
+    WB_XLOG_LEVEL_DEBUG = 3,
+    WB_XLOG_LEVEL_TRACE = 4,
+};
+
+// ---------------------------------------------------------------------------
+// 写入模式
+// ---------------------------------------------------------------------------
+
+enum WbXlogMode {
+    WB_XLOG_MODE_ASYNC = 0,   // 异步模式（默认）：mmap 缓冲 + 后台线程刷盘
+    WB_XLOG_MODE_SYNC  = 1,   // 同步模式：每次 write 直接刷盘
+};
+
+// ---------------------------------------------------------------------------
+// 初始化配置
+// ---------------------------------------------------------------------------
+
+struct WbXlogConfig {
+    const char* log_dir;        // 日志输出目录（必填）
+    const char* name_prefix;    // 日志文件名前缀（必填），如 "sandbox_12345"（调用方可自行拼入 pid 实现多实例隔离）
+    int         level;          // 最大日志级别 (WbXlogLevel)
+    int         mode;           // 写入模式 (WbXlogMode)
+    uint64_t    max_file_size;  // 单文件最大字节数，0 = 默认 10MB
+    int         max_alive_days; // 日志文件最大保留天数，0 = 默认 7 天
+    bool        compress;       // 是否启用 zlib 压缩
+};
+
+// ---------------------------------------------------------------------------
+// 生命周期
+// ---------------------------------------------------------------------------
+
+/// 初始化 xlog 引擎。成功返回 true，失败返回 false。
+/// 可重复调用，第二次及以后的调用将被忽略。
+bool wb_xlog_init(const struct WbXlogConfig* config);
+
+/// 关闭 xlog 引擎，刷盘并释放所有资源。
+/// 关闭后再调用 write 会静默丢弃。
+void wb_xlog_close(void);
+
+// ---------------------------------------------------------------------------
+// 日志写入
+// ---------------------------------------------------------------------------
+
+/// 写入一条日志。
+/// @param level   日志级别
+/// @param tag     模块标签（如 crate name）
+/// @param file    源文件名（可为 NULL）
+/// @param func    函数名（可为 NULL）
+/// @param line    行号（0 表示未知）
+/// @param msg     日志正文（UTF-8）
+void wb_xlog_write(int level, const char* tag,
+                   const char* file, const char* func, int line,
+                   const char* msg);
+
+// ---------------------------------------------------------------------------
+// 控制
+// ---------------------------------------------------------------------------
+
+/// 刷盘（异步模式下通知后台线程，不阻塞）。
+void wb_xlog_flush(void);
+
+/// 同步刷盘（阻塞直到当前缓冲区全部落盘）。
+void wb_xlog_flush_sync(void);
+
+/// 动态修改日志级别。
+void wb_xlog_set_level(int level);
+
+/// 动态修改单文件最大字节数。
+void wb_xlog_set_max_file_size(uint64_t max_bytes);
+
+/// 动态修改日志保留天数。
+void wb_xlog_set_max_alive_days(int days);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // WB_XLOG_BRIDGE_H