mirror of
https://github.com/morluto/rea.git
synced 2026-10-31 11:56:12 +00:00
76 lines
2.8 KiB
TypeScript
76 lines
2.8 KiB
TypeScript
import type {
|
|
CapabilityDescriptor,
|
|
ProviderIdentity,
|
|
} from "../application/AnalysisProvider.js";
|
|
import { createAnalysisProfile } from "../domain/analysisProfile.js";
|
|
import { NATIVE_TOOL_CONTRACTS } from "../contracts/native/nativeToolContracts.js";
|
|
|
|
/** Public identity committed by macOS-native inspection observations. */
|
|
export const NATIVE_MACOS_PROVIDER_IDENTITY: ProviderIdentity = Object.freeze({
|
|
id: "native-macos",
|
|
name: "macOS native inspection utilities",
|
|
version: null,
|
|
});
|
|
/** Source-owned commitment for the pure Apple dispatch metadata reader. */
|
|
export const APPLE_DISPATCH_METADATA_ANALYSIS_PROFILE = createAnalysisProfile(
|
|
{
|
|
id: NATIVE_MACOS_PROVIDER_IDENTITY.id,
|
|
name: NATIVE_MACOS_PROVIDER_IDENTITY.name,
|
|
version: "apple-metadata-reader-2",
|
|
},
|
|
{
|
|
operation: "inspect_native_dispatch_metadata",
|
|
reader: "apple-dispatch-metadata",
|
|
revision: 2,
|
|
},
|
|
);
|
|
/** Operations whose target process can show UI, use the network and write files. */
|
|
const OWNED_PROCESS_OPERATIONS: ReadonlySet<string> = new Set([
|
|
"capture_native_ui_scenario",
|
|
"observe_native_calls",
|
|
]);
|
|
|
|
/** Declare native host coverage without creating a command runner. */
|
|
export const nativeMacOSCapabilities = (
|
|
platform: NodeJS.Platform = process.platform,
|
|
): readonly CapabilityDescriptor[] => {
|
|
const available = platform === "darwin";
|
|
return Object.freeze(
|
|
[
|
|
...NATIVE_TOOL_CONTRACTS,
|
|
{ name: "inspect_native_dispatch_metadata" as const },
|
|
].map((contract): CapabilityDescriptor => {
|
|
const availability = available
|
|
? ({ available: true, reason: null } as const)
|
|
: ({
|
|
available: false,
|
|
availabilityCode: "unsupported_host",
|
|
reason: "Native macOS utilities require macOS.",
|
|
} as const);
|
|
return Object.freeze({
|
|
provider: NATIVE_MACOS_PROVIDER_IDENTITY,
|
|
operation: contract.name,
|
|
...(contract.name === "inspect_native_dispatch_metadata"
|
|
? { analysisProfile: APPLE_DISPATCH_METADATA_ANALYSIS_PROFILE }
|
|
: {}),
|
|
...availability,
|
|
effects: Object.freeze({
|
|
mutatesArtifact: false,
|
|
launchesProcess: contract.name !== "inspect_native_dispatch_metadata",
|
|
mayShowUi: OWNED_PROCESS_OPERATIONS.has(contract.name),
|
|
mayAccessNetwork: OWNED_PROCESS_OPERATIONS.has(contract.name),
|
|
mayWriteFilesystem:
|
|
OWNED_PROCESS_OPERATIONS.has(contract.name) ||
|
|
contract.name === "observe_native_ui" ||
|
|
contract.name === "inspect_signature",
|
|
changesPermissions: false,
|
|
requiresRoot: false,
|
|
}),
|
|
limitations: Object.freeze([
|
|
"Availability and textual formats depend on the installed macOS/Xcode toolchain.",
|
|
]),
|
|
});
|
|
}),
|
|
);
|
|
};
|