import path from "node:path";

import { isNotFoundPathError, isPathInside } from "./path-guards.js";

export type BoundaryPathIntent = "read" | "write" | "create" | "delete" | "stat";

type BoundaryPathIntent = "read" | "write" | "create" | "delete" | "stat";

export type BoundaryPathAliasPolicy = {

allowFinalSymlinkForUnlink?: boolean;

}),

} as const;

export type ResolveBoundaryPathParams = {

type ResolveBoundaryPathParams = {

absolutePath: string;

rootPath: string;

boundaryLabel: string;

rootCanonicalPath?: string;

};

export type ResolvedBoundaryPathKind = "missing" | "file" | "directory" | "symlink" | "other";

type ResolvedBoundaryPathKind = "missing" | "file" | "directory" | "symlink" | "other";

export type ResolvedBoundaryPath = {

absolutePath: string;

};

}

export async function resolvePathViaExistingAncestor(targetPath: string): Promise<string> {

async function resolvePathViaExistingAncestor(targetPath: string): Promise<string> {

const normalized = path.resolve(targetPath);

let cursor = normalized;

const missingSuffix: string[] = [];

import { detectBinary } from "./detect-binary.js";

import { isWSL } from "./wsl.js";

export type BrowserOpenCommand = {

type BrowserOpenCommand = {

argv: string[] | null;

reason?: string;

command?: string;

};

export type BrowserOpenSupport = {

type BrowserOpenSupport = {

ok: boolean;

reason?: string;

command?: string;

import { isImplicitSameChatApprovalAuthorization } from "../plugin-sdk/approval-auth-helpers.js";

import { normalizeMessageChannel } from "../utils/message-channel.js";

export type ApprovalCommandAuthorization = {

type ApprovalCommandAuthorization = {

authorized: boolean;

reason?: string;

explicit: boolean;

import fs from "node:fs/promises";

import path from "node:path";

export type DetectedPackageManager = "pnpm" | "bun" | "npm";

type DetectedPackageManager = "pnpm" | "bun" | "npm";

export async function detectPackageManager(root: string): Promise<DetectedPackageManager | null> {

try {

/\((?:request_id|trace_id)\s*:\s*([A-Za-z0-9._:-]{1,128})\)/i,

] as const;

export type DiagnosticErrorFailureKind =

type DiagnosticErrorFailureKind =

| "aborted"

| "connection_closed"

| "connection_reset"

readonly traceFlags?: string;

};

export type DiagnosticTraceContextInput = Partial<DiagnosticTraceContext> & {

type DiagnosticTraceContextInput = Partial<DiagnosticTraceContext> & {

traceparent?: string;

};

import { isDiagnosticFlagEnabled } from "./diagnostic-flags.js";

import { isTruthyEnvValue } from "./env.js";

export const OPENCLAW_DIAGNOSTICS_TIMELINE_SCHEMA_VERSION = "openclaw.diagnostics.v1";

const OPENCLAW_DIAGNOSTICS_TIMELINE_SCHEMA_VERSION = "openclaw.diagnostics.v1";

export type DiagnosticsTimelineEventType =

type DiagnosticsTimelineEventType =

| "span.start"

| "span.end"

| "span.error"

| "provider.request"

| "childProcess.exit";

export type DiagnosticsTimelineAttributes = Record<string, string | number | boolean | null>;

type DiagnosticsTimelineAttributes = Record<string, string | number | boolean | null>;

export type DiagnosticsTimelineEvent = {

type DiagnosticsTimelineEvent = {

type: DiagnosticsTimelineEventType;

name: string;

timestamp?: string;

import fs from "node:fs";

import path from "node:path";

export const LOW_DISK_SPACE_WARNING_THRESHOLD_BYTES = 1024 * 1024 * 1024;

const LOW_DISK_SPACE_WARNING_THRESHOLD_BYTES = 1024 * 1024 * 1024;

export type DiskSpaceSnapshot = {

type DiskSpaceSnapshot = {

targetPath: string;

checkedPath: string;

availableBytes: number;