@cicctencent/agent-server 0.2.68 → 0.2.70

package/dist/cjs/spi/observability-store.d.ts

@@ -0,0 +1,67 @@
+import type { ObservationRecord, ObservabilityStats, ScoreRecord, SessionRecord, StatsQueryOptions, TraceQueryOptions, TraceRecord, ObservationQueryOptions } from '@cicctencent/agent-core';
+export interface ObservabilityStoreProvider {
+    saveTrace(trace: TraceRecord): Promise<TraceRecord>;
+    updateTrace(traceId: string, data: Partial<TraceRecord>): Promise<void>;
+    getTraces(query: TraceQueryOptions): Promise<{
+        items: TraceRecord[];
+        total: number;
+    }>;
+    getTraceById(traceId: string): Promise<TraceRecord | null>;
+    saveObservation(observation: ObservationRecord): Promise<ObservationRecord>;
+    updateObservation(observationId: string, data: Partial<ObservationRecord>): Promise<void>;
+    getObservations(query: ObservationQueryOptions): Promise<{
+        items: ObservationRecord[];
+        total: number;
+    }>;
+    getObservationsByTrace(traceId: string): Promise<ObservationRecord[]>;
+    upsertSession(session: Partial<SessionRecord> & {
+        sessionId: string;
+    }): Promise<SessionRecord>;
+    getSessions(query: Partial<SessionRecord>): Promise<SessionRecord[]>;
+    saveScore(score: ScoreRecord): Promise<ScoreRecord>;
+    getScores(traceId: string): Promise<ScoreRecord[]>;
+    getStats(query: StatsQueryOptions): Promise<ObservabilityStats>;
+    cleanup(olderThanDays: number): Promise<number>;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+}
+export declare class InMemoryObservabilityStore implements ObservabilityStoreProvider {
+    private traces;
+    private observations;
+    private scores;
+    private sessions;
+    private traceIndex;
+    private observationIndex;
+    private enabled;
+    private readonly maxTraces;
+    private readonly maxObservations;
+    constructor(maxTraces?: number, maxObservations?: number);
+    saveTrace(trace: TraceRecord): Promise<TraceRecord>;
+    updateTrace(traceId: string, data: Partial<TraceRecord>): Promise<void>;
+    getTraces(query: TraceQueryOptions): Promise<{
+        items: TraceRecord[];
+        total: number;
+    }>;
+    getTraceById(traceId: string): Promise<TraceRecord | null>;
+    saveObservation(observation: ObservationRecord): Promise<ObservationRecord>;
+    updateObservation(observationId: string, data: Partial<ObservationRecord>): Promise<void>;
+    getObservations(query: ObservationQueryOptions): Promise<{
+        items: ObservationRecord[];
+        total: number;
+    }>;
+    getObservationsByTrace(traceId: string): Promise<ObservationRecord[]>;
+    upsertSession(session: Partial<SessionRecord> & {
+        sessionId: string;
+    }): Promise<SessionRecord>;
+    getSessions(query: Partial<SessionRecord>): Promise<SessionRecord[]>;
+    saveScore(score: ScoreRecord): Promise<ScoreRecord>;
+    getScores(traceId: string): Promise<ScoreRecord[]>;
+    getStats(query: StatsQueryOptions): Promise<ObservabilityStats>;
+    cleanup(olderThanDays: number): Promise<number>;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    private filterTraces;
+    private computeGroups;
+}
+export type { ObservationRecord, ObservabilityStats, ScoreRecord, SessionRecord, StatsQueryOptions, TraceQueryOptions, TraceRecord, ObservationQueryOptions, ObservabilityUsage, ObservationType, ObservabilityStatus, } from '@cicctencent/agent-core';
+//# sourceMappingURL=observability-store.d.ts.map

package/dist/cjs/spi/observability-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-store.d.ts","sourceRoot":"","sources":["../../../src/spi/observability-store.ts"],"names":[],"mappings":"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"}

package/dist/cjs/spi/observability-store.js

@@ -0,0 +1,329 @@
+"use strict";
+// ============================================================
+// Observability SPI - ObservabilityStoreProvider interface
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryObservabilityStore = void 0;
+// ============================================================
+// InMemoryObservabilityStore - 默认内存环形缓冲实现
+// ============================================================
+class InMemoryObservabilityStore {
+    traces = [];
+    observations = [];
+    scores = [];
+    sessions = new Map();
+    // Map 索引：将 updateTrace/updateObservation 从 O(n) 降为 O(1)
+    traceIndex = new Map(); // traceId -> traces 数组下标
+    observationIndex = new Map(); // observationId -> observations 数组下标
+    enabled = true;
+    maxTraces;
+    maxObservations;
+    constructor(maxTraces = 10000, maxObservations = 50000) {
+        this.maxTraces = maxTraces;
+        this.maxObservations = maxObservations;
+    }
+    async saveTrace(trace) {
+        if (!this.enabled)
+            return trace;
+        this.traces.push(trace);
+        this.traceIndex.set(trace.traceId, this.traces.length - 1);
+        if (this.traces.length > this.maxTraces) {
+            // 重建索引（仅在超限时触发，不频繁）
+            const removed = this.traces.splice(0, this.traces.length - this.maxTraces);
+            for (const r of removed)
+                this.traceIndex.delete(r.traceId);
+            // 重建剩余索引
+            this.traceIndex.clear();
+            for (let i = 0; i < this.traces.length; i++) {
+                this.traceIndex.set(this.traces[i].traceId, i);
+            }
+        }
+        return trace;
+    }
+    async updateTrace(traceId, data) {
+        if (!this.enabled)
+            return;
+        const idx = this.traceIndex.get(traceId);
+        if (idx != null && idx < this.traces.length && this.traces[idx]?.traceId === traceId) {
+            this.traces[idx] = { ...this.traces[idx], ...data };
+        }
+    }
+    async getTraces(query) {
+        const filtered = this.filterTraces(query);
+        const total = filtered.length;
+        const page = query.page ?? 1;
+        const pageSize = query.pageSize ?? 50;
+        const offset = query.offset ?? (page - 1) * pageSize;
+        const limit = query.limit ?? pageSize;
+        const items = filtered
+            .sort((a, b) => b.startTime - a.startTime)
+            .slice(offset, offset + limit);
+        return { items, total };
+    }
+    async getTraceById(traceId) {
+        const idx = this.traceIndex.get(traceId);
+        if (idx != null && idx < this.traces.length && this.traces[idx]?.traceId === traceId) {
+            return this.traces[idx];
+        }
+        return null;
+    }
+    async saveObservation(observation) {
+        if (!this.enabled)
+            return observation;
+        this.observations.push(observation);
+        this.observationIndex.set(observation.id, this.observations.length - 1);
+        if (this.observations.length > this.maxObservations) {
+            const removed = this.observations.splice(0, this.observations.length - this.maxObservations);
+            for (const r of removed)
+                this.observationIndex.delete(r.id);
+            this.observationIndex.clear();
+            for (let i = 0; i < this.observations.length; i++) {
+                this.observationIndex.set(this.observations[i].id, i);
+            }
+        }
+        return observation;
+    }
+    async updateObservation(observationId, data) {
+        if (!this.enabled)
+            return;
+        const idx = this.observationIndex.get(observationId);
+        if (idx != null && idx < this.observations.length && this.observations[idx]?.id === observationId) {
+            this.observations[idx] = { ...this.observations[idx], ...data };
+        }
+    }
+    async getObservations(query) {
+        let filtered = this.observations;
+        if (query.traceId)
+            filtered = filtered.filter(o => o.traceId === query.traceId);
+        if (query.type)
+            filtered = filtered.filter(o => o.type === query.type);
+        if (query.name)
+            filtered = filtered.filter(o => o.name === query.name);
+        if (query.status)
+            filtered = filtered.filter(o => o.status === query.status);
+        if (query.startTime)
+            filtered = filtered.filter(o => o.startTime >= query.startTime);
+        if (query.endTime)
+            filtered = filtered.filter(o => (o.endTime ?? o.startTime) <= query.endTime);
+        const total = filtered.length;
+        const page = query.page ?? 1;
+        const pageSize = query.pageSize ?? 50;
+        const offset = query.offset ?? (page - 1) * pageSize;
+        const limit = query.limit ?? pageSize;
+        const items = filtered
+            .sort((a, b) => a.startTime - b.startTime)
+            .slice(offset, offset + limit);
+        return { items, total };
+    }
+    async getObservationsByTrace(traceId) {
+        return this.observations
+            .filter(o => o.traceId === traceId)
+            .sort((a, b) => a.startTime - b.startTime);
+    }
+    async upsertSession(session) {
+        const existing = this.sessions.get(session.sessionId);
+        const updated = {
+            sessionId: session.sessionId,
+            userId: session.userId ?? existing?.userId,
+            threadId: session.threadId ?? existing?.threadId,
+            applicationId: session.applicationId ?? existing?.applicationId,
+            agentProfileId: session.agentProfileId ?? existing?.agentProfileId,
+            traceCount: (existing?.traceCount ?? 0) + 1,
+            firstSeenAt: existing?.firstSeenAt ?? Date.now(),
+            lastSeenAt: Date.now(),
+            metadata: { ...existing?.metadata, ...session.metadata },
+        };
+        this.sessions.set(session.sessionId, updated);
+        return updated;
+    }
+    async getSessions(query) {
+        let result = Array.from(this.sessions.values());
+        if (query.userId)
+            result = result.filter(s => s.userId === query.userId);
+        if (query.threadId)
+            result = result.filter(s => s.threadId === query.threadId);
+        if (query.applicationId)
+            result = result.filter(s => s.applicationId === query.applicationId);
+        return result.sort((a, b) => (b.lastSeenAt ?? 0) - (a.lastSeenAt ?? 0));
+    }
+    async saveScore(score) {
+        if (!this.enabled)
+            return score;
+        this.scores.push(score);
+        return score;
+    }
+    async getScores(traceId) {
+        return this.scores.filter(s => s.traceId === traceId);
+    }
+    async getStats(query) {
+        let traces = this.traces;
+        if (query.applicationId)
+            traces = traces.filter(t => t.applicationId == query.applicationId);
+        if (query.agentProfileId)
+            traces = traces.filter(t => t.agentProfileId == query.agentProfileId);
+        if (query.sessionId)
+            traces = traces.filter(t => t.sessionId === query.sessionId);
+        if (query.threadId)
+            traces = traces.filter(t => t.threadId == query.threadId);
+        if (query.userId)
+            traces = traces.filter(t => t.userId === query.userId);
+        if (query.startTime)
+            traces = traces.filter(t => t.startTime >= query.startTime);
+        if (query.endTime)
+            traces = traces.filter(t => (t.endTime ?? t.startTime) <= query.endTime);
+        const totalTraces = traces.length;
+        const successCount = traces.filter(t => t.status === 'ok').length;
+        const errorCount = traces.filter(t => t.status === 'error').length;
+        const timeoutCount = traces.filter(t => t.status === 'timeout').length;
+        const durations = traces.filter(t => t.durationMs != null).map(t => t.durationMs);
+        const avgDurationMs = durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+        const traceIds = new Set(traces.map(t => t.traceId));
+        const traceObservations = this.observations.filter(o => traceIds.has(o.traceId));
+        const generationCount = traceObservations.filter(o => o.type === 'generation').length;
+        const toolCallCount = traceObservations.filter(o => o.name !== 'agent.iteration' && o.type === 'span').length;
+        const totalTokens = traces.reduce((sum, t) => {
+            const u = t.usage;
+            return sum + (u?.totalTokens ?? 0);
+        }, 0);
+        const totalCost = traces.reduce((sum, t) => sum + (t.cost ?? t.usage?.cost ?? 0), 0);
+        const stats = {
+            totalTraces,
+            totalObservations: traceObservations.length,
+            successCount,
+            errorCount,
+            timeoutCount,
+            successRate: totalTraces > 0 ? successCount / totalTraces : 0,
+            avgDurationMs,
+            totalTokens,
+            totalCost,
+            generationCount,
+            toolCallCount,
+        };
+        if (query.groupBy) {
+            stats.groups = this.computeGroups(traces, traceObservations, query.groupBy);
+        }
+        return stats;
+    }
+    async cleanup(olderThanDays) {
+        const cutoff = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
+        const beforeTraces = this.traces.length;
+        const beforeObs = this.observations.length;
+        const removedTraceIds = new Set();
+        this.traces = this.traces.filter(t => {
+            if (t.startTime < cutoff) {
+                removedTraceIds.add(t.traceId);
+                return false;
+            }
+            return true;
+        });
+        this.observations = this.observations.filter(o => !removedTraceIds.has(o.traceId));
+        this.scores = this.scores.filter(s => !removedTraceIds.has(s.traceId) || s.timestamp >= cutoff);
+        // 重建索引
+        this.traceIndex.clear();
+        for (let i = 0; i < this.traces.length; i++)
+            this.traceIndex.set(this.traces[i].traceId, i);
+        this.observationIndex.clear();
+        for (let i = 0; i < this.observations.length; i++)
+            this.observationIndex.set(this.observations[i].id, i);
+        return (beforeTraces - this.traces.length) + (beforeObs - this.observations.length);
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    // ---- helpers ----
+    filterTraces(query) {
+        let result = this.traces;
+        if (query.traceId)
+            result = result.filter(t => t.traceId === query.traceId);
+        if (query.sessionId)
+            result = result.filter(t => t.sessionId === query.sessionId);
+        if (query.threadId)
+            result = result.filter(t => t.threadId == query.threadId);
+        if (query.applicationId)
+            result = result.filter(t => t.applicationId == query.applicationId);
+        if (query.agentProfileId)
+            result = result.filter(t => t.agentProfileId == query.agentProfileId);
+        if (query.userId)
+            result = result.filter(t => t.userId === query.userId);
+        if (query.status)
+            result = result.filter(t => t.status === query.status);
+        if (query.startTime)
+            result = result.filter(t => t.startTime >= query.startTime);
+        if (query.endTime)
+            result = result.filter(t => (t.endTime ?? t.startTime) <= query.endTime);
+        return result;
+    }
+    computeGroups(traces, observations, groupBy) {
+        const groups = new Map();
+        for (const trace of traces) {
+            let key;
+            switch (groupBy) {
+                case 'application':
+                    key = String(trace.applicationId ?? 'unknown');
+                    break;
+                case 'agent':
+                    key = String(trace.agentProfileId ?? 'unknown');
+                    break;
+                case 'model': {
+                    const genObs = observations.find(o => o.traceId === trace.traceId && o.type === 'generation' && o.model);
+                    key = genObs?.model || 'unknown';
+                    break;
+                }
+                case 'tool': {
+                    // tool grouping is per-observation, handled below
+                    continue;
+                }
+                case 'status':
+                    key = trace.status;
+                    break;
+                case 'day': {
+                    const d = new Date(trace.startTime);
+                    key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+                    break;
+                }
+                default:
+                    key = 'unknown';
+            }
+            const g = groups.get(key) || { count: 0, successCount: 0, errorCount: 0, totalDuration: 0, totalTokens: 0, totalCost: 0 };
+            g.count++;
+            if (trace.status === 'ok')
+                g.successCount++;
+            if (trace.status === 'error')
+                g.errorCount++;
+            g.totalDuration += trace.durationMs ?? 0;
+            g.totalTokens += trace.usage?.totalTokens ?? 0;
+            g.totalCost += trace.cost ?? trace.usage?.cost ?? 0;
+            groups.set(key, g);
+        }
+        // tool grouping: iterate observations instead
+        if (groupBy === 'tool') {
+            for (const obs of observations) {
+                if (obs.type !== 'span' || obs.name === 'agent.iteration')
+                    continue;
+                const key = obs.name;
+                const g = groups.get(key) || { count: 0, successCount: 0, errorCount: 0, totalDuration: 0, totalTokens: 0, totalCost: 0 };
+                g.count++;
+                if (obs.status === 'ok')
+                    g.successCount++;
+                if (obs.status === 'error')
+                    g.errorCount++;
+                g.totalDuration += obs.durationMs ?? 0;
+                groups.set(key, g);
+            }
+        }
+        return Array.from(groups.entries()).map(([key, g]) => ({
+            key,
+            count: g.count,
+            successCount: g.successCount,
+            errorCount: g.errorCount,
+            avgDurationMs: g.count > 0 ? g.totalDuration / g.count : 0,
+            totalTokens: g.totalTokens,
+            totalCost: g.totalCost,
+        }));
+    }
+}
+exports.InMemoryObservabilityStore = InMemoryObservabilityStore;
+//# sourceMappingURL=observability-store.js.map

package/dist/cjs/spi/observability-store.js.map

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

package/dist/cjs/spi/store-sink-factory.d.ts

@@ -0,0 +1,10 @@
+import type { ObservabilitySink } from '@cicctencent/agent-core';
+import type { ObservabilityStoreProvider } from './observability-store.js';
+/**
+ * 创建一个将数据转发到 ObservabilityStoreProvider 的 Sink 实现。
+ * 所有方法吞掉错误，不影响主业务流程。
+ *
+ * 共享实现，供 agent-server 和 work-client 复用，避免代码重复。
+ */
+export declare function createStoreSink(provider: ObservabilityStoreProvider): ObservabilitySink;
+//# sourceMappingURL=store-sink-factory.d.ts.map

package/dist/cjs/spi/store-sink-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-sink-factory.d.ts","sourceRoot":"","sources":["../../../src/spi/store-sink-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,0BAA0B,GAAG,iBAAiB,CAuHvF"}

package/dist/cjs/spi/store-sink-factory.js

@@ -0,0 +1,134 @@
+"use strict";
+// ============================================================
+// storeSink factory - 创建转发到 ObservabilityStoreProvider 的 Sink
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStoreSink = createStoreSink;
+/**
+ * 创建一个将数据转发到 ObservabilityStoreProvider 的 Sink 实现。
+ * 所有方法吞掉错误，不影响主业务流程。
+ *
+ * 共享实现，供 agent-server 和 work-client 复用，避免代码重复。
+ */
+function createStoreSink(provider) {
+    return {
+        async startTrace(ctx) {
+            const traceId = ctx.traceId || `trace_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            const startTime = Date.now();
+            try {
+                await provider.saveTrace({
+                    traceId,
+                    sessionId: ctx.sessionId,
+                    threadId: ctx.threadId,
+                    applicationId: ctx.applicationId,
+                    agentProfileId: ctx.agentProfileId,
+                    userId: ctx.userId,
+                    name: ctx.name,
+                    input: ctx.input,
+                    status: 'active',
+                    startTime,
+                    metadata: ctx.metadata,
+                });
+                if (ctx.sessionId) {
+                    await provider.upsertSession({
+                        sessionId: ctx.sessionId,
+                        userId: ctx.userId,
+                        threadId: ctx.threadId,
+                        applicationId: ctx.applicationId,
+                        agentProfileId: ctx.agentProfileId,
+                    }).catch(() => { });
+                }
+            }
+            catch (e) {
+                console.warn('[Observability] startTrace failed:', e instanceof Error ? e.message : e);
+            }
+            return { traceId, startTime, sampled: true };
+        },
+        async endTrace(traceId, data) {
+            try {
+                const endTime = Date.now();
+                await provider.updateTrace(traceId, {
+                    output: data?.output,
+                    status: data?.status ?? 'ok',
+                    endTime,
+                    durationMs: data?.startTime != null ? endTime - data.startTime : undefined,
+                    usage: data?.usage,
+                    cost: data?.cost,
+                    error: data?.error,
+                });
+            }
+            catch (e) {
+                console.warn('[Observability] endTrace failed:', e instanceof Error ? e.message : e);
+            }
+        },
+        async startObservation(ctx) {
+            const observationId = `obs_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            const startTime = Date.now();
+            try {
+                await provider.saveObservation({
+                    id: observationId,
+                    traceId: ctx.traceId || '',
+                    parentObservationId: ctx.parentObservationId,
+                    type: ctx.type,
+                    name: ctx.name,
+                    model: ctx.model,
+                    provider: ctx.provider,
+                    input: ctx.input,
+                    status: 'active',
+                    startTime,
+                    metadata: ctx.metadata,
+                });
+            }
+            catch (e) {
+                console.warn('[Observability] startObservation failed:', e instanceof Error ? e.message : e);
+            }
+            return { observationId, traceId: ctx.traceId || '', startTime, sampled: true };
+        },
+        async endObservation(observationId, data) {
+            try {
+                await provider.updateObservation(observationId, {
+                    output: data?.output,
+                    status: data?.status ?? 'ok',
+                    endTime: Date.now(),
+                    durationMs: data?.durationMs,
+                    usage: data?.usage,
+                    model: data?.model,
+                    provider: data?.provider,
+                    error: data?.error,
+                    metadata: data?.metadata,
+                });
+            }
+            catch (e) {
+                console.warn('[Observability] endObservation failed:', e instanceof Error ? e.message : e);
+            }
+        },
+        async recordEvent(ctx) {
+            try {
+                const observationId = `evt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+                await provider.saveObservation({
+                    id: observationId,
+                    traceId: ctx.traceId || '',
+                    type: 'event',
+                    name: ctx.name,
+                    input: ctx.input,
+                    output: ctx.output,
+                    status: 'ok',
+                    startTime: Date.now(),
+                    metadata: ctx.metadata,
+                });
+            }
+            catch (e) {
+                console.warn('[Observability] recordEvent failed:', e instanceof Error ? e.message : e);
+            }
+        },
+        async recordScore(score) {
+            try {
+                await provider.saveScore(score);
+            }
+            catch (e) {
+                console.warn('[Observability] recordScore failed:', e instanceof Error ? e.message : e);
+            }
+        },
+    };
+}
+//# sourceMappingURL=store-sink-factory.js.map

package/dist/cjs/spi/store-sink-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-sink-factory.js","sourceRoot":"","sources":["../../../src/spi/store-sink-factory.ts"],"names":[],"mappings":"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"}

package/dist/cjs/tool/tools/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAEvE,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAiYxD"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAEvE,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CA+YxD"}

package/dist/cjs/tool/tools/filesystem.js

@@ -53,7 +53,9 @@ function createFilesystemTools() {
                         'IMPORTANT: Do NOT use heredoc (cat > file << EOF) to write scripts - the content will be truncated. ' +
                         'To write script files, use write_file (or append_file for long scripts), then use execute_command with a short command to run them. ' +
                         'SANDBOX RESTRICTIONS: Commands run inside a sandboxed directory. ' +
-                        'NEVER use absolute paths (like /Users/..., /home/...) for file output - ALL file writes will be BLOCKED. ' +
+                        'ALL file access (reads AND writes) is restricted to the sandbox directory by a path-isolation guard. ' +
+                        'NEVER use absolute paths or ~/ for file paths (like /Users/..., /home/..., ~/.codebuddy/...) - ' +
+                        'any command referencing a path OUTSIDE the sandbox will be BLOCKED. ' +
                         'Use relative paths: "report.html", "gen.cjs", etc. ' +
                         'NEVER use `find /` for filesystem search - use `find . -name "file"` or `ls -la` instead.',
                     parameters: {
@@ -306,6 +308,18 @@ function createFilesystemTools() {
                     const fs = await Promise.resolve().then(() => __importStar(require('fs')));
                     const path = await Promise.resolve().then(() => __importStar(require('path')));
                     const sandbox = ctx.custom?.sandbox;
+                    // 沙箱隔离：search_code 只能在沙箱目录内搜索，禁止传入宿主机绝对路径
+                    // （如 /Users/...、/home/...、/etc/...），防止借搜索能力遍历宿主机文件系统。
+                    if (args.path && typeof args.path === 'string' && path.isAbsolute(args.path)) {
+                        const sandboxRoot = sandbox?.rootDir;
+                        if (sandboxRoot) {
+                            const rel = path.relative(path.resolve(sandboxRoot), path.resolve(args.path));
+                            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+                                return `[Sandbox blocked] search_code path "${args.path}" is outside the sandbox directory. ` +
+                                    `Search is restricted to the sandbox (use a relative path or omit "path" to search the whole sandbox).`;
+                            }
+                        }
+                    }
                     const rootPath = args.path || sandbox?.rootDir || process.cwd();
                     const pattern = args.pattern;
                     const globPattern = args.glob || '**/*';